サービス

技能：エンジニア

技能：デザイナー

技能：ビジネス職

技能：バックオフィス

ジャンル

<h2>初めに</h2>

7日目は電子書籍事業部iOSチームの長谷川が担当します。

iOSチームではDMMブックスを日々保守運用しています。 
<a href="https://apps.apple.com/jp/app/dmm%E3%83%96%E3%83%83%E3%82%AF%E3%82%B9-%E9%9B%BB%E5%AD%90%E6%9B%B8%E7%B1%8D%E3%83%AA%E3%83%BC%E3%83%80%E3%83%BC/id481155379" target="_blank">DMMブックス 電子書籍リーダー</a>

DMMブックスは電子書籍リーダーなので購入機能はありませんが、ストアで購入後にアプリを起動するリンクを設置しています。 このディープリンクは元々Custome URL Schemeで実装していたため、アプリがインストールされていない時はエラーが表示されるだけで機能しません。 アプリがインストールされていないときはAppStoreへ遷移すると嬉しいよねってことでFirebase Dynamic Links(以下、FDL)を導入することになりました。 初めて扱うFDLとUniversal Linkに戸惑いつつも無事に実装できたので、ささやかですがつまづいたことの対処法をまとめてみました。

<h2 id="トラブル1実機で動作しない">トラブル1.実機で動作しない</h2>

シミュレータでは問題なく動作するのに、実機ではアプリ起動すらしないという事象に陥ってないでしょうか。

そんな時は最初に設定の見直しをおすすめします。

<h3 id="App-ID-プレフィックスとFirebaseプロジェクトのTeam-IDは一致しているか">App ID プレフィックスとFirebaseプロジェクトのTeam IDは一致しているか</h3>

プロビジョニングファイルを見てみるとApp IDは<code>&lt;Prefix&gt;.&lt;Bundle ID&gt;</code>という要素で成り立っています。

FDLのドキュメントにあるApp ID プレフィックスとはこの<code>&lt;Prefix&gt;</code>の部分を指しています。

例

<code>App ID: DMMBOOKS.BOOKS</code>

&uarr;この場合は<code>DMMBOOKS</code>がApp ID プレフィックスとなります。

大抵はこのプレフィックスにチームIDの値が割り当てられていますが、全てのアプリがそうではありません。

DMMブックスもApp IDプレフィックスとチームIDが一致していなかったため、それに気づくまで実機で動きませんでした。

FDLでは自動で<a href="https://developer.apple.com/documentation/xcode/supporting-associated-domains" target="_blank">apple-app-site-associationファイル</a>を作ってくれて便利ですが、プロジェクトのTeam IDをApp IDプレフィックに使います。

そのため、apple-app-site-associationファイルを自前で用意しない限り、FirebaseプロジェクトのTeam IDにはプロビジョニングファイルのApp IDプレフィックスを設定する必要があるわけですね。 プロジェクトのTeam IDを変更して翌日には反映されていたので、URL接頭辞を登録後でも修正可能です。

&nbsp;

確認方法

App IDプレフィックスの一致に関しては設定を目視で確認するよりも、FDLに用意されているiOS自己診断ツールを使えば一発で分かります。

<a href="https://firebase.google.com/docs/dynamic-links/debug?hl=ja" target="_blank">動的リンクのデバッグ | Firebase Dynamic Links</a>

&nbsp;
コンソール出力例


<pre>
<code>---- Firebase Dynamic Links diagnostic output start ----
Firebase Dynamic Links framework version 2.1.0
System information: OS iOS, OS version 11.0, model iPhone
Current date 2017-08-14 22:52:56 +0000
AutomaticRetrievalEnabled: YES
ERROR: Specified custom URL scheme is com.your.app but Info.plist do not contain such scheme in CFBundleURLTypes key.
AppID Prefix: DMMBOOKS, Team ID: DMMTV, AppId Prefix equal to Team ID: NO
performDiagnostic detected 1 ERRORS.
---- Firebase Dynamic Links diagnostic output end ----</code></pre>

Custome URL Schemeについてエラーが発生していますが、今回は使わないので特に問題ありません。

エラーとして表示されないから見過ごしてしまいがちですが、ちゃんとApp IDプレフィックスがTeam IDと一致しているか伝えてくれていますね。

<h2 id="トラブル2ブレークポイントが壊れた">トラブル2.ブレークポイントが壊れた</h2>

FDLと直接関係ありませんが、デバッグ時に直面して困ってしまったので書いておきます。

ディープリンクをタップでアプリ起動させてデバッグしたいというケースがよくあると思います。 そういう時にSchemeのLaunchを<code>Wait for executable to be launched</code>オプションに設定しますよね。

ですがコード変更後は一度<code>Automatically</code>でRunしないと変更が反映されまれません。

普段使わないオプションなだけに知らなかったのですが、アプリが流し込まれないのか、ブレークポイントの位置が大幅にずれたり止まらなかったり。 実装が上手くいってないのか困惑する羽目になるのでLaunchのオプション変更には注意です。

<h2 id="最後に">最後に</h2>

FDLの導入でつまづいたことを書いてみました。

<ul>
	<li>FirebaseプロジェクトのTeam ID == App ID プレフィックスの一致確認</li>
	<li>コード変更後は<code>Automatically</code>でRun</li>
</ul>

基本的に設定さえ間違えなければ、FDLは無料で使えてドキュメントや導入記事など揃っていることもあり導入しやすいです。 実装もコード量は少なく済むので大きな変更にはなりませんでした。

リマインダーやメモに作成したテスト用のダイナミックリンクを入力しておくとデバッグが楽なのでおすすめです。

この記事のような設定ミスはあまり遭遇しないと思いますが、困ってる方の参考になれば幸いです。

この記事は、DMMグループAdvent Calendar 2022　7日目の記事になります。

DMMブックス

電子書籍

アドベントカレンダー2022

Dynamic Links導入時につまづいたこと

プラットフォーム開発本部

facebook

twitter

DMM TV

DMM pictures

DMM GAMES

DMMオンクレ

DMMスクラッチ

DMMくじ

DMM Factory

DMM FILMS

ぷらさぷ ～＋SURPRISE～

DMMオンラインサロン

DMMいろいろレンタル

DMM DVD／CDレンタル

DMM通販

DMMオンラインクリニック

デジタルコミック事業

DMMチャットブースト

DMM英会話

DMM FX

DMMかりゆし水族館

ベルリング

ハッシャダイソーシャル

ヤンキーインターン

シント=トロイデンVV

DMM 地方創生

DMM.make 3Dプリント

DMM.make PRODUCTS

Seamoon Protcol by DMM Crypto

DMMバヌーシー

DMM EV ON

DMM WEBCAMP

DMMぱちタウン

DMM競輪

Waitinglist

Algoage

DMMポイントクラブ

社会課題

エンターテインメント

動画

アニメ

ゲーム

アプリゲーム

コミュニティ

オンラインサロン

PCゲーム

通販

オンラインイベント

ビジネスソリューション

教育

英会話

水族館

ハードウェア・プロダクト

救急車両

消防車両

モノづくり施設

サッカー

スポーツ

地方創生

VR体験

Web3

生成AI

研究開発

アプリ

ブロックチェーン

プラットフォーム

横断開発

社会インフラ

アミューズメント

ダイバーシティ

同人

サーバサイド

バックエンド

フロントエンド

ネットワーク

セキュリティ

ITインフラ

配信基盤

ペイメント

Android

データベース

ビッグデータ

データ分析

機械学習（ML）

MLOps

VR開発

フルスタック

プロトタイピング

グラフィックデザイン

イラスト作成

3DCG

モーショングラフィック

Dynamic Links導入時につまづいたこと

シェア

関連する求人

関連する記事

関連するサービス