ScratchAssetWeb / Windows

クラウド同期のセットアップ手順（Cloudflare R2 の場合）

同期先の用意からアプリへの接続まで、目安は 15 分ほどです。Cloudflare のアカウント（無料）を使います。

Cloudflare 側の準備（手順 1〜5）

1. アカウントを作る：Cloudflare のサインアップページで登録します（無料）。確認メールのリンクを開いて完了させてください。
2. R2 を有効化する：ダッシュボード左メニューの「R2」から、利用開始の手続きを進めます。支払い方法の登録を求められますが、無料枠（ストレージ 10GB まで等）の範囲なら料金はかかりません。
3. バケットを作る：「バケットを作成」から、名前（半角の英小文字・数字・ハイフン。例：scratchasset）を付けて作成します。場所の設定は初期値のままで大丈夫です。
4. アカウント ID を控える：R2 の概要ページに表示される「アカウント ID」（32 文字の英数字）をメモします。
5. API トークンを作る：「API トークンを管理」から「アカウント API トークンを作成」。権限は「オブジェクトの読み取りと書き込み」、対象は作成したバケットのみに指定します。表示されるアクセスキー ID とシークレットアクセスキーを、両方とも控えてください。

手順 6：CORS の設定

バケットを開き、「設定」タブ → CORS ポリシーの「ポリシーを追加」で、下記の JSON をそのまま貼り付けて保存します（Web 版と Windows 版、両方の住所を許可する設定です）。

[
  {
    "AllowedOrigins": [
      "https://scratchasset.pages.dev",
      "app://bundle"
    ],
    "AllowedMethods": ["GET", "PUT", "DELETE", "HEAD"],
    "AllowedHeaders": ["*"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

アプリ側の接続（手順 7〜9）

7. アプリの設定 → クラウド同期で、プロバイダー「Cloudflare R2」を選び、次の 4 つを入力します。

   入力欄	入れる値
   Cloudflare アカウント ID	手順 4 で控えたアカウント ID
   バケット名	手順 3 で作ったバケットの名前
   アクセスキー ID	手順 5 のアクセスキー ID
   シークレットアクセスキー	手順 5 のシークレットアクセスキー

8. 「接続テスト」で「接続できました」を確認したら、「接続して同期を開始」を押します。詳細設定のプレフィックスは、初期値（scratchasset/v1/）のままで大丈夫です。
9. 2 台目以降の端末でも、プレフィックスを含めてまったく同じ設定を入力すれば、同じライブラリが同期されます。

（任意）共有リンクを使う場合

バケットの「設定」→ パブリックアクセスで r2.dev サブドメインを有効化し、表示される公開 URL（https://pub-….r2.dev の形）を、アプリのクラウド同期の詳細設定 → 公開ベースURL に入力します（接続する前に入れるのがおすすめです。接続済みの場合は、一度「接続を解除」してから設定し直してください）。r2.dev を有効化すると、そのバケットの中身は URL を知っている人が読み取りできる状態になります。公開したくないファイルは、同じバケットに入れないでください。