使用ライブラリ - 「今僕たちに必要な買い物」

「今僕たちに必要な買い物」は Apache License, Version 2.0 適用の OpenCSV を利用しています。

バックアップ/リストア機能 - 「今僕たちに必要な買い物」

※注意事項
画像中の言語は英語になっていますが、これは英語版マニュアルと同じ画像を使用しているからです。
言語設定が日本語になっていれば、日本語で表示されます。

ここでは、バックアップ/リストア機能について説明します。

このアプリのバックアップは、データをCSVファイルに出力します。
リストアは、そのファイルからデータを復旧します。
次のようなときに使うと便利です。

(1) カタログを大幅に変更する前（間違えてもやり直しが効く）
(2) 一度このアプリをアンインストールするとき（帰りをお待ちしております）
(3) スマートフォンを機種変するとき（エクスポート/インポート機能として使用。データ移行が可能）
(4) 別の誰かに自分のカタログをあげたいとき（エクスポート/インポート機能として使用）

バックアップの対象は、品物、カテゴリ、メモのデータのみで、各画面の設定情報（メモ表示のタイプやソート順など）は保存されません。
他にも注意事項がありますので、３．注意事項をよく読み、その内容を理解してからこの機能を使用してください。

それでは早速やってみましょう。

１．バックアップ

メニュー画面

メニュー画面でMenuキーを押し、「バックアップ/リストア」を選択してください。

バックアップ/リストアダイアログ

「バックアップ/リストアダイアログ」が表示されます。
最初は「前回のバックアップ時刻」が空欄になります。

では「バックアップ」ボタンを押してください。
確認ダイアログが表示され、「OK」ボタンを押すとCSVファイルを書き出します。

CSVファイルは、「SDカードのルート/ymgcsng/shp.csv」というパスで作られます。
SDカードのルートは、お使いの機種によって「/sdcard」だったり「/mnt/sdcard」だったりします。

２．リストア

バックアップ/リストアダイアログ

先程と同様にメニュー画面から「バックアップ/リストア」メニューを選び、「バックアップ/リストアダイアログ」を表示してください。今度は「前回のバックアップ時刻」に先程の時間が表示されているはずです。

では「リストア」ボタンを押してください。
確認ダイアログが表示され、「OK」ボタンを押すとCSVファイルを読み込みます。
読み込みが終わると、データがバックアップ時点のものに戻ります。

３．注意事項

(1) バックアップの対象は品物、カテゴリ、メモのデータのみで、設定情報は保存されません。
(2) 同名のカテゴリは同じカテゴリとして統合されます。
同じ名前のカテゴリをどうしても使いたい場合は、バックアップ前に一度別名に変えて、リストア後に元の名前に戻してください。

４．（上級）編集してインポート

バックアップファイルはCSVファイルなので、CSVエディタやテキストエディタで編集できます。
ですので、多くのアイテムを一括で登録したい場合、アプリから１つ１つ登録するよりも、CSVファイルを編集したほうが恐らくずっと楽にできます。
ただし、手作業でのデータ編集はデータの不整合を引き起こすことがあり得るため、CSVファイルを編集するときは細心の注意を払ってください。

○手順
(1) 「SDカードのルート/ymgcsng/shp.csv」のファイルをPC等に送ってください。
（例えば、PCとスマートフォンファイルの同期ソフトを使う、「アストロファイルマネージャ」などのファイル管理アプリでファイルを送信、など）

(2) PCでCSVファイルを編集してください。
※エンコードがUTF-8なので、Excelでは文字化けします。
他のCSVエディタを使用するか、もしくはExcelを使うならば次の手順で開いてください。
 (i) ファイルの拡張子を.csvから.txtに変更する
 (ii) Excelの「ファイル」メニュー→「開く」で開く
 (iii) テキストファイルウィザードが立ち上がるので、そのまま「次へ」ボタンを押す
 (iv) 区切り文字で「カンマ」のチェックボックスをONにして「完了」ボタンを押す
ただし、ExcelではCSV形式で保存するとエンコードがSJISになるので、テキストエディタなどでエンコードをUTF-8に変換し直す必要があります。

(3) 編集したファイルをAndroid端末に送信し、「SDカードのルート/ymgcsng/shp.csv」に置いてください。
※(2)でファイルの拡張子を.txtに変更していた場合、.csvに直してください。


○各項目について

項目	入力形式	備考
品名	テキスト	必須。空欄の場合、その行は無視される
買い物メモに追加	半角数字	買い物リストに表示するなら「1」
常備	半角数字	在庫管理するなら「1」
在庫状況	半角数字	○なら「2」、△なら「1」、×なら「0」
購入済み	半角数字	買い物リストでチェック済みにするなら「1」
デフォルト位置	半角数字	カテゴリ内での順番を0から
目安価格	半角数字
場所	テキスト
場所のデフォルト位置	半角数字	ソート指定しなかった場合の場所の順番を0から。同じ場所で異なるデフォルト位置がある場合は、最初のものが使われる。指定しない場合は最後尾。
有効期限	半角数字、「/」	年2桁/月2桁/日2桁
メモ	テキスト
ワンメモ	テキスト
カテゴリ	テキスト	空欄の場合「***」になる
カテゴリのデフォルト位置	半角数字	ソート指定しなかった場合のカテゴリの順番を0から。同じカテゴリで異なるデフォルト位置がある場合は、最初のものが使われる。指定しない場合は最後尾。

○注意事項
(1) カラムの並び順は固定なので、入れ替えないでください。
(2) 先頭１行目はヘッダーで読み飛ばします。（ただし、カラム数のチェックはします）
１行目を消さないでください。
(3) 品名が無かったりカラム数が異なったりして、読み込めなかった行は現在警告が出ません。
アプリで各品物が登録されているかチェックするか、もう一度バックアップを取って比較するなどして、確認してください。

「今僕たちに必要な買い物」バージョン1.2をリリースしました

Androidアプリ「今僕たちに必要な買い物」バージョン1.2をリリースしました。
↓からどうぞ
http://market.android.com/details?id=jp.ymgcsng.shp

新作をやるつもりだったのに、いくつも要望を頂いたので、こっちに全力を注ぎました。
要望をいただけるっていうことは、使って頂いてるってことで、とても嬉しいものですね。
要望を全て叶えようと思ったら全然時間が足りなくて、前回のリリースから１月半も経ってしまいました。
２月中にリリースと言っていたのが、こんなギリギリになってしまって、大変申し訳ありません。

といっても、まだ完成というわけではありません。
マニュアルの修正が全然未着手なので、明日明後日で直します。（また英語の時間か。。。）

今回は大幅な機能追加をしたので、学ぶこともたくさんありました。
それらも近日中にまとめようと思います。



今回はほんとにしんどかった。。。
機能を増やすと、それに伴って改善要望や不具合対応が出てくるはずなので、
まだまだゆっくりできないことを覚悟しつつ、今日のところは酒飲んで寝ることにします。

経過報告その２

CSVバックアップの実装がほぼ完了。
OpenCSVを使用したけれど、ちょっとハマったので、それも後日記録に残します。
あとは機能的にはソート関連のみですが、全体通してのテストをじっくりやる時間が取れなさそうなのが気がかり。
なんとか今月中リリースを目指します。


胃もたれが治らない。
睡眠不足が悪いのだろうけど、寝る時間がなかなか。。。

経過報告

悪いくせが出て、なかなか進んでいません。
細かいところを気にしてしまって、本筋が遅れてしまっています。
諸事情で、未だにアプリ製作の時間がなかなかとれないこともあり、ぎりぎり今月末にリリースできるかどうか、といったところです。

1. バックアップ・リストア機能
   未着手。使用するライブラリの下調べと、仕様は考えてあるので、１日あれば実装できるかなぁというところ。
2. ウィジェット対応
   機能は実装済み。あとは画像を用意するぐらいでOK。
3. メモの強化
   ほぼ終了。少し画像を作成する必要があるが、それが終われば微調整して完了。
4. 買い物リストの表示形式追加
   ほぼ終了。
5. その他（バグフィックスやソートの調整）
   バグフィックスは完了。ソート関係はまだ未着手。

マニュアル作成もあるので、それを考えると時間が厳しい。特に英訳。

場合によっては、マニュアルは作成中として、とりあえずソフトだけ先にリリースになるかもしれません。

頭が痛い。お腹が痛い。腕が痛い（これは筋肉痛）。なんかボロボロな状態。

健康な体が欲しい。

「今僕たちに必要な買い物」実装予定について

グローバルに要望をいただいていて、それらは全て実装する予定です。
それと、自分でもこういうのがあったらいいかなぁと思いついた物もやろうと考えています。
今現在、予定しているものはざっと以下な感じ。

1. バックアップ・リストア機能
   データをCSV形式で出力し、またそれを取り込む機能。出力したファイルを編集して、アイテムの一括登録なんてことも可能にします。
2. ウィジェット対応
   4x1のウィジェットを作ろうかなぁと考えています。各画面へのショートカットと、購入済み品物数/購入予定品物数の表示にするつもり。
3. メモの強化
1. メモの項目を増やします。「場所（購入する店や街の名前などを想定）」と「期限（食べ物の賞味期限や薬の消費期限などを想定）」を追加します。
2. メモの表示方法を「無し（アイコンをクリックでメモ表示）」「簡易（一部だけ表示されていて、アイコンをクリックで全部表示）」「全部（はじめから全部表示されている）」の３つに分けます。
3. 買い物リスト画面だけでなく、カタログ編集画面でもメモを表示します。
4. メモを「今だけメモ」と「ずっとメモ」に分けます。「今だけメモ」は購入したら内容が消えます。「ずっとメモ」は消えずに残ります（今の「メモ」と同じ）。
5. 買い物リスト画面からのメモ編集は「今だけメモ」になります。カタログ編集画面からのメモ編集は「ずっとメモ」になります。
4. 買い物リストの表示形式追加
   カテゴリや場所、期限によって、グルーピングできるようにします。
5. 有料版
   広告なし、テーマ変更が可能な有料版を用意します。１００円ぐらいを予定。

その他、UIの改善などもします。

列挙すると、そのボリュームに押しつぶされそうですが、やりましょう。

有料版はいつになるかちょっと分からないですが、それ以外は今月を目処に完成させて、リリースします。

リリースペースが遅くて申し訳ないですが、あたたかい目で見守ってください。

要望が溜まってきたけど失踪は絶対しないぞ

ご無沙汰です。
別にサボっていたわけじゃありません。
むしろ頑張っていたぐらい。

最近は
・要望のまとめ
・リファクタリング（機能を変えずに中の構造を変えること）
・インフルエンザにかかった娘の看病
・ゲーム
・漫画
・DIY
などなどで多忙な日々を送っており、なんか書くのが億劫だっただけです。

でも、やっぱり記録を残すって、何かと大事だと思うので、また明日からチョコチョコ書いていこうかなと。
少しずつね、少しずつ。

さて、今日は壁に棚でも付けて寝るかな。。。