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

  • URLをコピーしました!
目次

🔧 今回やったこと(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をコピーしました!

この記事を書いた人

調剤薬局で働く現役薬剤師です。
医療現場の非効率さに疑問を持ち、独学でプログラミングを習得しました。
今では、ReactやPythonを使って現場の業務を効率化するツールを自作しています。
このブログでは、医療や薬局業務に役立つIT活用術や、プログラミング初心者の方に向けた実践的な学習ノウハウを発信しています。

目次