MENU

TWAアプリ公開前に必須!Digital Asset Linksの設定手順まとめ

目次

🔧 今回やったこと(Digital Asset Links設定)

🛠 問題

TWAアプリのテストリンクで「アイテムが見つかりません」エラーが発生しました。これは、TWAアプリとWebサイト間の所有権証明ができていないために起こるものです。

✅ 解決策

  • SHA256フィンガープリントの取得
    keytool -printcert -jarfile app-release-signed.apk
  • assetlinks.jsonファイルの作成
    public/.well-known/assetlinks.json を作成し、TWAアプリとWebサイトの関連付けを定義
  • Vercel設定の更新
    vercel.json/.well-known/assetlinks.json のヘッダー設定を追加
  • デプロイ
    GitHubにプッシュしてVercelに自動デプロイ

📋 今後のアプリ開発タスクリスト

  • 🌐 PWA(Progressive Web App)の場合 → Apply
  • 📱 TWA(Trusted Web Activity)の場合 → Apply
  • 🏪 Google Play Console作業 → Apply

🎯 今回の作業が必要になる条件

✅ 必要な場合:

  • TWAアプリを開発している
  • 独自ドメインでWebアプリを公開している
  • Google Playでアプリを公開したい

❌ 不要な場合:

  • 純粋なネイティブAndroidアプリ
  • PWAのみでアプリストア公開しない
  • GitHub Pagesや無料ホスティングのみ使用

📝 具体的な手順テンプレート

  1. SHA256フィンガープリント取得
    Apply

    Run: keytool -printcert -jarfile app-release-signed.apk
  2. assetlinks.json作成
    Apply
  3. ファイル配置
    Apply
  4. 検証
    Apply

⚠️ 重要ポイント

  • TWAアプリでのみ必要な設定
  • 独自ドメイン必須(GitHub Pagesでは不可)
  • SHA256フィンガープリントは正確に入力
  • ファイルパスは必ず /.well-known/assetlinks.json
  • HTTPS必須(HTTPでは動作しない)

🔄 今後の開発フロー

この設定はTWAアプリ特有のものなので、通常のWebアプリやネイティブアプリ開発では不要です。
今後TWAアプリを開発する際は、このタスクを必ず含めてください!

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

現役の薬剤師として調剤薬局で勤務しながら、コミュニケーションとプログラミングに関する知見を発信しています。
毎日の調剤業務では30人以上の患者様と対話しており、医療現場で培った「相手に伝わる話し方」や「信頼関係の築き方」といった実践的なコミュニケーション術を記事にしています。特に、専門的な内容をわかりやすく伝える技術や、緊張せずに会話を続けるコツなど、現場で即活用できるノウハウを中心にご紹介しています。

また、業務効率化に興味を持ったことをきっかけにプログラミングを独学で習得。現在は医療現場でのIT活用事例や、初心者向けのプログラミング学習法についても発信しています。
医療従事者の視点と、自らプログラミングを学んだ経験を活かし、専門的な内容をわかりやすくお伝えすることを心がけています。記事を通して、読者の皆様のスキルアップや業務改善にお役立ちできれば幸いです。

コメント

コメントする

目次