CloudflareでPWAを作る際にハマったService Worker Blob問題とiOS/Android
こんにちは、ちゃつです。
家族向けPWA「タスクマスター」をCloudflare Workers + KV + Pagesで構築したとき、Service Workerの通知がiOS/Androidで一切届かないという問題に詰まりました。
TL;DR
- Service WorkerをBlob URLで登録するとiOS/Androidでプッシュ通知が届かない
- sw.jsを独立ファイルに分離してルートパスで配信することで解決
- setIntervalはバックグラウンドで止まる。タイマー処理はWorker Cron Triggersに移譲する
構成
- フロントエンド: 単一HTMLファイル(Cloudflare Pagesにデプロイ)
- バックエンド: Cloudflare Workers + KV(データ永続化・同期・Push通知)
- 月額コスト: 家族数人の利用なら無料枠で収まる
コーディングは主にAIエージェントが担当し、設計の方向性を指示しながらバージョンを重ねています。v3.1〜v3.5で本記事を書き、v7で追記しています。
アーキテクチャ
各コンポーネントの役割
| コンポーネント | 役割 |
|---|---|
| Cloudflare Pages | HTMLファイルのホスティング |
| Cloudflare Workers | REST API(データ取得・保存・Push配信) |
| Cloudflare KV | 家族データのJSON永続化 |
| Service Worker | Push通知受信・オフラインキャッシュ |
| localStorage | 端末ごとのキャッシュ(オフライン対応) |
KVのデータ設計
family:{CODE} → {
tasks: [...],
rewards: [...],
points: number,
parentPin: string,
...
}
家族コード(6桁)をキーとしてJSONを丸ごと保存。KVの無料枠(書き込み1,000回/日・読み取り10万回/日)で余裕で収まります。
機能一覧
タスク管理
- カテゴリ:
study/chore/health/hobby/other - ポイント:
low=5pt /medium=10pt /high=20pt - テンプレートからクイック追加
const TEMPLATES = [
{ title: '国語の見開きワーク1ページ', category: 'study', priority: 'medium', icon: '📖', studyAmount: 1 },
{ title: '風呂を洗う', category: 'chore', priority: 'medium', icon: '🛁' },
];
ごほうびシステム
rewards: [
{ title: 'ゲーム30分延長', cost: 10, icon: '🎮' },
{ title: '好きなおやつ', cost: 600, icon: '🍰' },
]
交換時はリアルタイムで保護者にPush通知が飛びます。
クラウド同期
家族コード(6桁)で複数端末を紐付け、30秒ポーリングで同期。タスク完了時は即時Push。
Service Worker Blob問題:iOSとAndroidで通知が届かない
失敗パターン:Blob URLでの登録
// NG: Blob方式 → iOS SafariやAndroid Chromeで通知が届かない
const blob = new Blob([swCode], { type: 'application/javascript' });
const swUrl = URL.createObjectURL(blob);
navigator.serviceWorker.register(swUrl);
iOS SafariはBlobからのService Worker登録を信頼しないという仕様上の制約です。ブラウザのDevToolsでは登録成功に見えますが、実際にはPush通知イベントが発火しません。
解決:sw.jsを独立ファイルに分離
// OK: 独立ファイルからの登録
navigator.serviceWorker.register('./sw.js');
sw.jsの構成(抜粋)
const CACHE_VERSION = 'v3.5.0';
self.addEventListener('push', event => {
const data = event.data?.json() ?? {};
event.waitUntil(
self.registration.showNotification(data.title || '通知', {
body: data.body || '',
icon: '/icon.png',
})
);
});
通知スケジュール(Cloudflare Workers Cron Triggers)
# wrangler.toml
[triggers]
crons = ["0 22 * * *", "0 11 * * *"]
# UTC 22:00 = JST 07:00 / UTC 11:00 = JST 20:00
| 時間 | 送信先 | 内容 |
|---|---|---|
| 毎朝 7:00 | 子ども | 今日のタスク一覧 |
| 毎晩 20:00 | 子ども | 全完了→おめでとう / 未完了→残り件数 |
| 毎晩 20:00 | 保護者 | 全完了時のみ通知 |
| タスク全完了時 | 保護者 | リアルタイム |
| ごほうび交換時 | 保護者 | リアルタイム |
バージョンフォルダ方式(AI開発のルール)
子供タスクアプリ/
├── v3/
├── v3.1/
├── v3.4/ ← 安定版(触らない)
└── v3.5/ ← 作業中
「稼働中のディレクトリを直接触らない」がAIエージェントと開発する上での最大の教訓です。AIエージェントの設定ファイルにこのルールを書いておくと、次のセッションでも自動的に守ってくれます。
デプロイ方法
cd taskmaster-worker
wrangler deploy
cp taskmaster-v3.html taskmaster-pages/index.html
wrangler pages deploy taskmaster-pages --project-name=taskmaster
無料枠の目安
| リソース | 無料枠 | 家族利用の目安 |
|---|---|---|
| Worker リクエスト | 10万/日 | 余裕 |
| KV 読み取り | 10万/日 | 余裕 |
| KV 書き込み | 1,000/日 | 余裕 |
| Pages 帯域 | 無制限 | — |
月額0円で運用できています。
v7追記:setIntervalはバックグラウンドで止まる
// NG: アプリを閉じると止まる
setInterval(() => { checkReminders(); }, 60000);
スマホでアプリを閉じた瞬間にJavaScriptが停止します。
解決:Worker Cronを毎分実行にする
[triggers]
crons = ["* * * * *"]
const jstNow = new Date(Date.now() + 9 * 60 * 60 * 1000);
const currentTime = String(jstNow.getUTCHours()).padStart(2, '0') + ':' + String(jstNow.getUTCMinutes()).padStart(2, '0');
const reminderTasks = todayTasks.filter(t =>
t.reminderTime === currentTime && !(t.completedDates && t.completedDates.includes(today))
);
for (const task of reminderTasks) {
await sendPushToFamily(env, familyCode, {
targetRole: 'child',
title: '⏰ タスクリマインダー',
body: `「${task.title}」をやる時間だよ!`,
tag: 'reminder-' + task.id,
});
}
全タスク完了通知をPUT /api/dataに追加
const allDone = todayTasks.length > 0 &&
todayTasks.every(t => t.completedDates && t.completedDates.includes(today));
if (allDone && newData.allDoneNotifiedDate !== today) {
newData.allDoneNotifiedDate = today;
await env.TASKMASTER_KV.put(`family:${code}`, JSON.stringify(newData));
sendPushToFamily(env, code, {
targetRole: 'parent',
title: '🎉 全タスク完了!',
body: `今日のタスクを全部クリアしました!💎 ${newData.points}pt 🔥 ${newData.streakDays}日連続`,
tag: 'all-done',
}).catch(e => console.error(e));
}
v7追記:TWA(Android APK化)のNotification API問題(未解決)
TWA(Trusted Web Activity)でラップしたAPKで 'Notification' in window が false になる問題が発生しました。assetlinks.jsonの設定・Chromeキャッシュのクリア・APK再インストールをすべて試しましたが、現時点で解決できていません。
同じ現象に遭遇して解決した方がいれば、コメントで教えていただけると助かります。
v10追記:UI/UX全面リニューアルとE2EE暗号化
v10(2026-04-15)で大幅にリニューアルしました。
UI/UXの変更:
- iOS風タブ4構成(ホーム/スケジュール/ごほうび/設定)
- ダークモード対応(
prefers-color-scheme: dark) - 保護者PIN認証がインライン展開に(画面遷移なし)
- 直近テスト警告カード + カウントダウン表示
- 同条件タスクのグルーピング(「全日付に適用」)
セキュリティの変更(v9〜):
- E2EE暗号化(AES-256-GCM、PBKDF2鍵導出)
- PINハッシュ化(SHA-256)
- データ削除エンドポイント(PIN認証付き)
- プライバシーポリシーページ追加
v3.5→v7→v10と進む中で、「家族で使うPWA」としてかなり実用的なレベルになりました。
今後の課題
- TWAのNotification API問題の調査継続
- 複数子供への対応(現状1ユーザーID前提の設計)
- KVからD1(SQLite)への移行検討
まとめ
- Service WorkerはBlobではなく独立ファイルで登録する
- バックグラウンド通知はWorker Cronで処理する
- TWAのNotification APIは現時点で未解決
参考になれば幸いです。
※この記事は、noteで公開した記事をZenn向けに技術詳細に振り切った記事です。
Discussion