iPhoneにdosyaのバックアップウィジェットを追加する

dosyaのiOS拡張機能は、システムの小・中サイズのファミリーにバックアップ状況を提供します。同じターゲットは、対応するiOSバージョンで実行中のバックアップ用ライブアクティビティも提供します。

ウィジェットには、BackupWidgetターゲットと共有App Groupを含む署名済みの本番ビルドまたは開発ビルドが必要です。Expo Goでは利用できません。

手順

1. iPhoneのホーム画面を長押しし、編集とAdd Widgetを選んでdosyaを検索します。
2. バックアップ状況を選び、小または中サイズを選択します。特大サイズとロック画面用のウィジェットファミリーは宣言されていません。
3. dosyaを開いてサインインします。アプリは共有スナップショットをすぐに初期化できますが、バックアップのスキャンが始まるまでワークスペース名は空欄です。
4. 少量のバックアップを開始し、ウィジェットのバックアップ中の状態をdosya内の進捗と比較します。
5. iOS 16.2以降でライブアクティビティが許可されている場合は、ロック画面またはDynamic Islandを確認します。
6. 実行を完了し、ウィジェットを再び開いて前回のバックアップ情報を確認します。待機中の名前は最後のスキャンから保持されるため、dosyaを開いてアクティブなワークスペースを確認します。

小・中サイズの表示

小サイズにはdosya.dev、リング内のストレージ空き容量、バックアップ中または保護済み、前回の実行時刻が表示されます。中サイズにはワークスペース名、使用率、空き、使用済みに加え、進捗と現在の速度、または前回のバックアップと前回の速度が表示されます。

ストレージ使用率が90%になると、リングと空き容量の表示が警告色に変わります。ストレージまたは前回の実行データがない場合はダッシュが表示されます。ウィジェットは使用中のdosyaテーマのライトとダークのパレットから、iPhoneの外観に合う方を選びます。

更新タイミングとライブアクティビティ

dosyaはフェーズ、テーマ、アクティブなワークスペースの変更時と実行完了時に、WidgetKitに即時更新を要求します。その他の進捗の送信は15秒に1回までに制限され、タイムラインは30分後の予備の更新を予定します。ストレージの値はアクティブなワークスペースへの問い合わせから取得されますが、workspaceNameはスキャン開始時にのみ設定され、実行が待機状態になっても残ります。初回実行前は名前が空欄になることがあり、待機中にワークスペースを切り替えた後は古い名前が残り、ストレージと一致しないことがあります。

ライブアクティビティは実行対象の合計が正の件数のときだけ開始し、フェーズが変わる場合を除いて3秒以上の間隔で更新され、処理がすべて終わると終了します。iOSではライブアクティビティを無効にできるため、表示されないだけでバックアップが停止したとは限りません。アプリ内で確認してください。

結果の確認

ホーム画面のウィジェットに、選んだ大きさとテーマで最新の共有スナップショットが反映されます。実際の保存先となるアクティブなワークスペースはdosyaで確認してください。対応する環境で実行中はライブアクティビティに別途進捗が表示され、完了後はウィジェットが保護済みと前回の実行情報の表示に切り替わります。

関連ガイド

• モバイルのバックアップを確認する
• 一時停止したバックグラウンドバックアップを修正する