CocoaPods との統合
ステップ1:CocoaPods のインストール
CocoaPods 経由で iOS SDK をインストールすると、インストールプロセスの大部分が自動化されます。CocoaPodsをインストールするには、CocoaPods入門ガイドを参照してください。
開始するには、次のコマンドを実行します。
1
$ sudo gem install cocoapods
CocoaPods に関して問題がある場合は、CocoaPods トラブルシューティングガイド を参照してください。
ステップ 2: Podfile の構築
CocoaPods Ruby Gem をインストールしたら、Xcode プロジェクトのディレクトリに Podfile
という名前のファイルを作成する必要があります。
バージョン7.4.0 以降、Braze Swift SDK には、static XCFrameworks およびdynamic XCFrameworks として追加の配布チャネルがあります。これらの形式のいずれかを代わりに使用する場合は、それぞれのリポジトリからのインストール手順に従います。
Podfile に次の行を追加します。
1
2
3
target 'YourAppTarget' do
pod 'BrazeKit'
end
BrazeKit
メインのSDK ライブラリが含まれ、分析およびプッシュ通知のサポートが提供されます。
ポッドの更新がマイナー バージョンの更新よりも小さいものを自動的に取得するように、Braze をバージョン管理することをお勧めします。これは pod 'BrazeKit' ~> Major.Minor.Build
のように見えます。大きな変更があっても、Braze SDK の最新バージョンを自動的に統合したい場合は、Podfile で pod 'BrazeKit'
を使用できます。
追加ライブラリ
Braze Swift SDK は、機能をスタンドアロンライブラリに分割し、開発者がプロジェクトにインポートする機能をより詳細に制御できるようにします。BrazeKit
に加えて、以下のライブラリをPodfile に追加できます。
ライブラリ | 詳細 |
---|---|
pod 'BrazeLocation' |
ロケーション分析とジオフェンスモニタリングのサポートを提供するロケーションライブラリ |
pod 'BrazeUI' |
アプリ内メッセージおよびコンテンツカード用の Braze 提供ユーザーインタフェースライブラリ。 |
拡張ライブラリ
BrazeNotificationServiceおよびBrazePushStoryは、追加機能を提供する拡張モジュールであり、メインアプリケーションターゲットに直接追加することはできません。代わりに、これらのモジュールごとに個別の拡張ターゲットを作成し、対応するターゲットに Braze モジュールをインポートする必要があります。
ライブラリ | 詳細 |
---|---|
pod 'BrazeNotificationService' |
リッチプッシュ通知のサポートを提供する通知サービス拡張ライブラリ |
pod 'BrazePushStory' |
プッシュストーリーのサポートを提供する通知コンテンツ拡張ライブラリ |
ステップ3:Braze SDK のインストール
Braze SDK CocoaPods をインストールするには、ターミナル内で Xcode アプリプロジェクトのディレクトリに移動し、次のコマンドを実行します。
1
pod install
この時点で、CocoaPods によって作成された新しい Xcode プロジェクトワークスペースを開くことができるはずです。Xcode プロジェクトの代わりに、必ずこの Xcode ワークスペースを使用してください。
が表示されます。
次のステップ
指示に従って統合を完了します。
CocoaPods による Braze SDK のアップデート
CocoaPod を更新するには、プロジェクトディレクトリ内で以下のコマンドを実行するだけです。
1
pod update