Contents
Fuelio のバックアップ方式概要
Fuelio ではデータ紛失や端末変更に備えて、ローカル保存・CSV エクスポート・Dropbox 同期の3つの手段が公式に提供されています。各方式は保存場所と自動化レベルが異なるため、利用シーンに合わせて使い分けることが重要です。本節ではそれぞれの特徴と、実運用で留意すべきポイントを簡潔にまとめます。
ローカル(内部)バックアップ
Fuelio は端末内部に SQLite データベース fuelio.db を保持します。アプリは外部ストレージへの権限が不要なため、ほとんどの Android デバイスで問題なく動作します。ただし 端末が故障・紛失した場合 は復元手段がありません。
CSV エクスポート
設定画面から手動で CSV ファイルを生成でき、UTF‑8・カンマ区切りのテキストとして保存されます。表計算ソフトや他アプリへのインポートが容易なため、データ持ち出しや第三者との共有に適しています【1】。
Dropbox 同期(公式 API)
Fuelio は Dropbox の API v2 を利用した自動バックアップ機能を備えています。認証は OAuth 2.0 に基づき、取得されたアクセストークンは 90 日間有効で自動リフレッシュされます(2024 年以降の実装)【2】。この方式はクラウド上に常時最新データが残るため、端末交換時の復元が最もシームレスです。
Dropbox 同期の有効化手順と公式 API 認証フロー
このセクションでは、Fuelio の設定画面から Dropbox 連携をオンにする具体的な操作と、裏側で行われる認証・トークン管理の流れを解説します。
設定画面から Dropbox 同期を有効化する手順
まずは Fuelio アプリ内で同期設定を行います。以下のステップに従えば数クリックで完了します。
- アプリ起動 → 右上メニュー(三点) → 「設定」 をタップ
- 左側タブから 「データ管理」 を選択
- 「Dropbox 同期」スイッチを ON に切り替える
※ スイッチをオンにすると、認証画面が自動で表示されます。
- 表示された Dropbox 認証ページで使用中のアカウントにサインインし、「許可」 をタップ
- 許可が完了すると、Fuelio はバックアップ対象(燃料追加・費用項目)を自動的に
Fuelio/backup/フォルダへ保存し始めます。
必要な権限と認証フローの概要
権限
| 権限 | 用途 |
|---|---|
| ストレージアクセス(Android 13+) | バックアップファイルを書き込むために必要です。設定画面で求められたら許可してください。 |
| Dropbox アカウント連携 | OAuth 2.0 によるアクセストークン取得・自動更新のために必須です。 |
認証フロー(簡易図)
- 認可リクエスト – Fuelio が
https://www.dropbox.com/oauth2/authorizeへリダイレクトし、スコープfiles.content.write files.content.readを要求 - ユーザー同意 – ユーザーが Dropbox のログイン・許可操作を実施
- 認可コード受領 – リダイレクト URI に付随した一時的な認可コードを Fuelio が取得
- アクセストークン交換 –
https://api.dropboxapi.com/oauth2/tokenへ POST。返却されるトークンは有効期限 90 日で、リフレッシュトークンも同時に取得【2】 - 自動リフレッシュ – トークンが期限切れになる直前に Fuelio がバックグラウンドでリフレッシュリクエストを送信し、ユーザー操作は不要
※ OAuth 2.0(正式には 2.1 ではなく 2.0)という表記が混在しがちですが、現在 Dropbox が公式に提供しているのは OAuth 2.0 です。
CSV エクスポートと Dropbox への保存方法
CSV は汎用的なバックアップ形式として広く利用されています。本節ではエクスポート手順と、生成したファイルを直接 Dropbox に保存する流れを示します。
CSV をエクスポートする手順
- 設定 > データ管理 へ移動
- 「CSV エクスポート」ボタンをタップ
- ファイル名は自動で
fuelio_backup_YYYYMMDD.csv(例:fuelio_backup_20240521.csv)となります - エクスポート完了後の 「共有」 メニューから Dropbox アプリ を選択し、任意のフォルダに保存
※ 端末が Android 13 以上の場合は外部ストレージへの書き込み権限が求められます。
CSV ファイル構造(抜粋)
| 列名 | データ型・例 |
|---|---|
date |
ISO 8601 日付文字列(2024-05-21T08:30:00+09:00) |
type |
fill_up(給油) / cost(費用) など |
amount |
給油量(リットル)または金額(円) |
price_per_unit |
リットルあたり価格(円)。給油以外は空白 |
odometer |
走行距離計測値(km) |
この形式は Fuelio のインポート機能でもそのまま使用でき、手動で編集する場合も UTF‑8・カンマ区切り を守れば問題なく取り込めます【1】。
Dropbox へ直接保存する方法
エクスポート画面の「共有」から Dropbox を選択すると、自動的に Fuelio/backup/ フォルダが作成され、ファイルはタイムスタンプ付きで配置されます。手順は以下の通りです。
- 「共有」→「Dropbox」
- 保存先フォルダを確認(デフォルトは
Fuelio/backup/) - 「保存」 をタップ
これだけでバックアップがクラウドに残るため、端末紛失時のリカバリーが容易になります。
別デバイスへの復元手順とバックアップ検証
新しいスマートフォンやタブレットへ乗り換える際は、Dropbox に保存した CSV をインポートするだけで過去の記録をすべて引き継げます。本節では具体的な操作と、データ整合性を確認するチェックリストをご紹介します。
復元手順(Android / iOS 共通)
- Fuelio アプリを最新バージョンでインストール
- 初回起動時に表示される「データ復元」画面で 「CSV インポート」 を選択
- もしくは設定 > データ管理 の 「CSV インポート」 ボタンを利用
- Dropbox アプリが開くので、事前にバックアップした
fuelio_backup_YYYYMMDD.csvを選択 - 「インポート」をタップし完了後、アプリ内の データプレビュー でレコード数が元と一致するか確認
バックアップ検証チェックリスト
| 検証項目 | 確認手順 |
|---|---|
| ファイルサイズ | Dropbox のウェブ UI で CSV のバイト数を確認し、端末上の fuelio.db と概算が合うか比較 |
| サンプルレコード | テキストエディタで先頭5行と最終5行を目視し、列順・デリミタが正しいことをチェック |
| データ件数一致 | アプリの「統計」画面で給油回数・合計費用を確認し、CSV の type 列別集計結果と照合 |
ポイント:検証はインポート直後に行い、差異があれば 再インポート か 手動で CSV を修正 してください。特に日付形式のローカライズ違い(例:
2024/05/21vs2024-05-21) が起きやすいため、ISO 8601 に統一しておくと安全です。
トラブルシューティングと Google ドライブ併用時の注意点
バックアップ・復元は基本的にスムーズですが、実務で遭遇しがちなエラーとその対処法をまとめました。また、Google ドライブを補助的に利用する場合の留意点も併せて解説します。
よくあるエラー例と対処法
| エラー | 主な原因 | 推奨対処 |
|---|---|---|
| 認証失敗 (401 Unauthorized) | アクセストークンが期限切れ、またはスコープ不足 | 設定画面で「Dropbox 同期」オフ → オン に切り替えて再認証 |
| 同期遅延 | ネットワーク不安定・バックグラウンド制限 | Wi‑Fi 環境で 「今すぐ同期」 を手動実行。Android のバッテリー最適化から Fuelio を除外 |
| CSV インポートエラー(列数不一致) | 手動編集時に余計なカンマや改行が混入 | テキストエディタで UTF‑8・カンマ区切りを再確認し、不要行を削除 |
| 0 バイトファイルが生成される | Dropbox アプリの「省データモード」有効化 | 設定 → データ使用量 → 「省データモード」をオフにして再アップロード |
Google ドライブ併用時の比較ポイント
Fuelio は Dropbox のみを公式にサポート していますが、CSV を手動で Google ドライブへ保存することは可能です。以下に両者の特徴をまとめました。
| 項目 | Dropbox(公式 API) | Google ドライブ |
|---|---|---|
| 自動同期 | アプリ内で自動実行(バックグラウンド) | 手動インポート/エクスポートのみ |
| 容量制限 | 無料プラン 2 GB、有料プランは無制限 | 無料プラン 15 GB(他サービスと共有) |
| API 対応度 | OAuth 2.0 完全対応・トークン自動更新【2】 | Fuelio 側で未実装(手動操作が必要) |
| ファイル衝突防止 | タイムスタンプ付与で上書き回避 | 同名ファイルは上書きされやすい |
| 併用時の注意点 | 同一 CSV を両方に保存すると重複管理が必要 | 復元時は「Dropbox → CSV」か「Google Drive → CSV」のどちらかを明示的に選択 |
実務上の推奨:自動バックアップは Dropbox のみで運用し、重要度の高いデータは Google ドライブへ手動コピーして二重保管するとリスク低減につながります。
実務向けチェックリスト
| 項目 | 確認事項 |
|---|---|
| 内部 DB | 端末紛失時のリカバリーは不可 → 必ずクラウドまたは CSV バックアップを作成 |
| CSV エクスポート | 設定 > データ管理 で手動エクスポート、UTF‑8・カンマ区切りか確認【1】 |
| Dropbox 同期有効化 | スイッチ ON → 認証完了後に Fuelio/backup/ フォルダが作成されたことをチェック |
| トークン管理 | 90 日自動リフレッシュが正常に機能しているか(エラー 401 が出ない)【2】 |
| 復元テスト | 新端末で CSV インポート後、統計画面の件数・金額が一致するか検証 |
| 二重バックアップ | 必要に応じて Google ドライブへ手動コピーし、保存先を明示的に管理 |
上記項目を定期的(例:月1回)に確認すれば、Fuelio の走行記録は安全に保管でき、端末変更やトラブル時にもスムーズに復旧できます。
参考文献
-
Fuelio 公式サポートページ – 「データのエクスポートとインポート」
https://fuelio.com/help/export-import -
Dropbox API ドキュメント – OAuth 2.0 認証フロー、トークン有効期限およびリフレッシュ方法
https://developers.dropbox.com/oauth-guide -
Google Play ストア – Fuelio アプリ情報(バージョン・更新履歴)
https://play.google.com/store/apps/details?id=com.kajda.fuelio
本稿は 2024 年時点で入手可能な公式情報を元に作成しています。実際のアプリ仕様はアップデートに伴い変更されることがありますので、最新バージョンのリリースノートをご確認ください。