多数のアプリを支えるAndroid App Links運用 〜Manifest動的変更で運用を楽にする話〜 / Managing Android App Links Across Many Apps: Easing Operations with Dynamic Manifest Updates

「YapTech Playground #1　モバイルアプリ開発編」登壇資料
https://yappli.connpass.com/event/359014/

「URLを起点に、外部からアプリの特定画面へユーザーをより安全かつシームレスに誘導したい」。この課題を解決するのがAndroid App Linksです。

本発表では、まずApp Linksの概要とヤプリでの開発方法を簡単にご紹介します。 さらに、多数のアプリを扱うヤプリだからこそ、App Linksをオプション機能として提供する中で直面した、ある厄介な課題に注目。この運用上の悩みを、ビルドフローに仕込んだ「Android App Linksの情報を動的に変更させる方法」でどのように解決したのか。その具体的なアプローチをコードを交えてご紹介します。

App Linksの導入を検討している方や、いざ実装する時に役立つかもしれないヒントとしていただければと思います。

Transcript

1. 多数のアプリを⽀える Android App Links運⽤ 〜Manifest動的変更で運⽤を楽にする話〜
2. SPEAKER 開発統括本部 プロダクト開発本部 開発1部 Androidグループ 伊藤 暉 • 1995年⽣まれ。北海道札幌市出⾝ • 2024年4⽉⼊社 • Androidエンジニア歴約7年
3. INDEX ⽬次 1. Android AppLinksとは 2. 実装時に直⾯した課題 a. Applinksを使⽤しないアプリには情報を記載しない b. アプリによってManifestに記載する情報を切り替える 3. 解決アプローチ 4. さいごに
4. Android AppLinksとは
5. ディープリンクの⼀種 WebサイトのURLをタップした際にセキュアかつ シームレスに アプリの特定コンテンツを直接開くための公式の仕組み 1. Android AppLinksとは ≒ iOSで⾔うUniversal Links
6. 2つの大きな特徴 1. Android AppLinksとは ⾼いセキュリティ 従来のリンク Android AppLinks シームレス URLをタップすると 「どのアプリで開きますか？」という 選択画⾯が表⽰され、⼀⼿間かかる 選択画⾯を完全にスキップし URLから直接アプリが起動する 第三者による「なりすまし」や 「リンクの乗っ取り」が可能 アプリとWebサイトが 「公式な関係である」ことを 検証‧承認しているので安全 公式ページ：https://developer.android.com/training/app-links?hl=ja
7. 実装時に直⾯した課題
8. 2. 実装時に直⾯した課題 AppLinks不使⽤アプリのManifestにAppLinks情報を記載すると Google Play Consoleで警告⽂が表⽰される ※Manifest ≒ Info.plist
9. 2. 実装時に直⾯した課題 Yappliのビルドフロー A社 B社 C社 manage (データ管理) サーバ A機能を使⽤ B機能は不使⽤ ストア情報 etc… Android ソースコード ビルド Aアプリ Bアプリ Cアプリ
10. 2. 実装時に直⾯した課題 Yappliでは1つのコードベースで約900のアプリをビルドできるが AppLinksを使⽤しないアプリでもAndroidManifestの AppLinksの情報(intent-filter)が残っており警告が表⽰された
11. 2. 実装時に直⾯した課題 アプリ毎にManifestに記載したい情報が異なる
12. 2. 実装時に直⾯した課題 Yappliのビルドフロー A社 B社 C社 manage (データ管理) サーバ A機能を使⽤ B機能は不使⽤ ストア情報 etc… Aアプリ Bアプリ Cアプリ Android ソースコード ビルド
13. 2. 実装時に直⾯した課題 1 <activity 2 android:name=".HogeHogeActivity" 3 android:exported="true"> 4 5 <intent-filter android:autoVerify="true"> 6 <action android:name="android.intent.action.VIEW" /> 7 8 <category android:name="android.intent.category.DEFAULT" /> 9 <category android:name="android.intent.category.BROWSABLE" /> 10 11 <data android:scheme="https" /> 12 <data android:pathPrefix=".*" /> 13 <data android:host="yappli.applinks.host" /> 14 15 </intent-filter> 16 </activity>
14. 2. 実装時に直⾯した課題 1 <activity 2 android:name=".HogeHogeActivity" 3 android:exported="true"> 4 5 <intent-filter android:autoVerify="true"> 6 <action android:name="android.intent.action.VIEW" /> 7 8 <category android:name="android.intent.category.DEFAULT" /> 9 <category android:name="android.intent.category.BROWSABLE" /> 10 11 <data android:scheme="https" /> 12 <data android:pathPrefix=".*" /> 13 <data android:host="yappli.applinks.host" /> 14 15 </intent-filter> 16 </activity> このhostをアプリ毎に変えたい
15. 解決アプローチ
16. 3. 解決アプローチ アプリビルド時にシェルスクリプトを実⾏し Manifestに情報(intent-filter)を追記する
17. 3. 解決アプローチ Yappliのビルドフロー A社 B社 C社 Aアプリ Bアプリ Cアプリ ここで 書き換える manage (データ管理) サーバ A機能を使⽤ B機能は不使⽤ ストア情報 etc… Android ソースコード ビルド
18. 3. 解決アプローチ # applinksのhostが設定されている場合のみ処理を行う if jq -e '.applinks.host | select(. != null and . != "")' "apps/$appId/app-params.json"; then # --- この中にAndroidManifest.xmlを編集する処理が続く --- # (処理の詳細は次のスライドで) fi
19. 3. 解決アプローチ # applinksのhostが設定されている場合のみ処理を行う if jq -e '.applinks.host | select(. != null and . != "")' "apps/$appId/app-params.json"; then # --- この中にAndroidManifest.xmlを編集する処理が続く --- # (処理の詳細は次のスライドで ) fi AppLinks不使⽤アプリのManifestにAppLinks情報を記載すると Google Play Consoleで警告⽂が表⽰される
20. 3. 解決アプローチ # applinksのhostが設定されている場合のみ処理を行う if jq -e '.applinks.host | select(. != null and . != "")' "apps/$appId/app-params.json"; then # --- この中にAndroidManifest.xmlを編集する処理が続く --- # (処理の詳細は次のスライドで ) fi AppLinks不使⽤アプリのManifestにAppLinks情報を記載すると Google Play Consoleで警告⽂が表⽰される
21. # 1. app-params.jsonからapplinksの値取得 applinks_data=$(jq -r '.applinks.host' "apps/$appId/app-params.json") # 2. 取得した値を元に<data>タグを動的に生成 generated_tags_string=$( echo "$applinks_data" | tr ',' '\n' | while IFS= read -r host ...; do ... generated_tag=" <data android:host=\"$trimmed_host\" />" echo "$generated_tag" done ) # 3. 生成したタグを含んだintent-filterを作成 intent_filter_string=$(cat << EOF <intent-filter android:autoVerify="true"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:pathPattern=".*" android:scheme="https" /> ${generated_tags_string} </intent-filter> EOF) 3. 解決アプローチ
22. # 1. app-params.jsonからapplinksの値取得 applinks_data=$(jq -r '.applinks.host' "apps/$appId/app-params.json") # 2. 取得した値を元に<data>タグを動的に生成 generated_tags_string=$( echo "$applinks_data" | tr ',' '\n' | while IFS= read -r host ...; do ... generated_tag=" <data android:host=\"$trimmed_host\" />" echo "$generated_tag" done ) # 3. 生成したタグを含んだintent-filterを作成 intent_filter_string=$(cat << EOF <intent-filter android:autoVerify="true"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:pathPattern=".*" android:scheme="https" /> ${generated_tags_string} </intent-filter> EOF) 3. 解決アプローチ app-params.jsonからapplinksの値取得 例：aaa.applink, bbb.applink, ccc.applink
23. # 1. app-params.jsonからapplinksの値取得 applinks_data=$(jq -r '.applinks.host' "apps/$appId/app-params.json") # 2. 取得した値を元に<data>タグを動的に生成 generated_tags_string=$( echo "$applinks_data" | tr ',' '\n' | while IFS= read -r host ...; do ... generated_tag=" <data android:host=\"$trimmed_host\" />" echo "$generated_tag" done ) # 3. 生成したタグを含んだintent-filterを作成 intent_filter_string=$(cat << EOF <intent-filter android:autoVerify="true"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:pathPattern=".*" android:scheme="https" /> ${generated_tags_string} </intent-filter> EOF) 3. 解決アプローチ 取得した値の数だけdataタグを⽣成
24. # 1. app-params.jsonからapplinksの値取得 applinks_data=$(jq -r '.applinks.host' "apps/$appId/app-params.json") # 2. 取得した値を元に<data>タグを動的に生成 generated_tags_string=$( echo "$applinks_data" | tr ',' '\n' | while IFS= read -r host ...; do ... generated_tag=" <data android:host=\"$trimmed_host\" />" echo "$generated_tag" done ) # 3. 生成したタグを含んだintent-filterを作成 intent_filter_string=$(cat << EOF <intent-filter android:autoVerify="true"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:pathPattern=".*" android:scheme="https" /> ${generated_tags_string} </intent-filter> EOF) 3. 解決アプローチ intent-filterに 作ったdataタグを埋め込む
25. 3. 解決アプローチ Yappliのビルドフロー A社 B社 C社 Aアプリ Bアプリ Cアプリ ここで 書き換える manage (データ管理) サーバ A機能を使⽤ B機能は不使⽤ ストア情報 etc… Android ソースコード ビルド
26. # 1. app-params.jsonからapplinksの値取得 applinks_data=$(jq -r '.applinks.host' "apps/$appId/app-params.json") # 2. 取得した値を元に<data>タグを動的に生成 generated_tags_string=$( echo "$applinks_data" | tr ',' '\n' | while IFS= read -r host ...; do ... generated_tag=" <data android:host=\"$trimmed_host\" />" echo "$generated_tag" done ) # 3. 生成したタグを含んだintent-filterを作成 intent_filter_string=$(cat << EOF <intent-filter android:autoVerify="true"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:pathPattern=".*" android:scheme="https" /> ${generated_tags_string} </intent-filter> EOF) 3. 解決アプローチ アプリ毎にManifestに記載する情報が異なる
27. # 1. app-params.jsonからapplinksの値取得 applinks_data=$(jq -r '.applinks.host' "apps/$appId/app-params.json") # 2. 取得した値を元に<data>タグを動的に生成 generated_tags_string=$( echo "$applinks_data" | tr ',' '\n' | while IFS= read -r host ...; do ... generated_tag=" <data android:host=\"$trimmed_host\" />" echo "$generated_tag" done ) # 3. 生成したタグを含んだintent-filterを作成 intent_filter_string=$(cat << EOF <intent-filter android:autoVerify="true"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:pathPattern=".*" android:scheme="https" /> ${generated_tags_string} </intent-filter> EOF) 3. 解決アプローチ アプリ毎にManifestに記載する情報が異なる
28. さいごに
29. 4. さいごに 1. Android AppLinksとは 2. 実装時に直⾯した課題 a. Applinksを使⽤しないアプリには情報を記載しない b. アプリによってManifestに記載する情報を切り替える 3. 解決アプローチ a. アプリビルド時にシェルスクリプトを実⾏しManifestにintent-filterを追記する
30. 4. さいごに AppLinks実装時に何か参考になれば幸いです！
31. ご清聴ありがとうございました！