手動統合
パッケージマネージャへのアクセス権がない場合(Swift Package Manager やCocoaPods など)、代わりにSwift SDK を手動で統合できます。
ステップ 1:Braze SDK をダウンロードする
GitHub の[Braze SDK リリースページに移動し、braze-swift-sdk-prebuilt.zip
をダウンロードします。
ステップ 2: フレームワークの選択
Braze Swift SDK にはさまざまなスタンドアローンXCFrameworks が含まれています。これにより、必要な機能を統合する自由が得られます。すべてを統合する必要はありません。次の表を参照して、XCF ワークを選択します。
パッケージ | 必須? | 説明 |
---|---|---|
BrazeKit |
Yes | 分析およびプッシュ通知のサポートを提供するメインSDK ライブラリ。 |
BrazeLocation |
No | 位置分析とジオフェンスモニタリングをサポートするロケーションライブラリ。 |
BrazeUI |
No | アプリ内メッセージおよびコンテンツカード用の Braze 提供ユーザーインタフェースライブラリ。 |
BrazeNotificationService |
No | リッチプッシュ通知をサポートする通知サービス拡張ライブラリ。このライブラリをメインアプリケーションターゲットに直接追加するのではなく、BrazeNotificationService ライブラリを別途追加. |
BrazePushStory |
No | プッシュストーリーをサポートする通知コンテンツ拡張ライブラリ。このライブラリをメインアプリケーションターゲットに直接追加するのではなく、BrazePushStory ライブラリを個別に追加します。 |
BrazeKitCompat |
No | Compatibility library Appboy とABK* のすべてのクラスとメソッドを含む互換性ライブラリ。Appboy-iOS-SDK バージョン4.X.X で使用できます。使用方法の詳細については、マイグレーションガイドの最小マイグレーションシナリオを参照してください。 |
BrazeUICompat |
No | Compatibility library ABK* のすべてのクラスとAppboyUI ライブラリでAppboy-iOS-SDK バージョン4.X.X から利用可能なメソッドを含む。使用方法の詳細については、マイグレーションガイドの最小マイグレーションシナリオを参照してください。 |
SDWebImage |
最小移行シナリオでBrazeUICompat のみが使用する依存関係 |
ステップ 3: ファイルの準備
Static またはDynamic XCFrameworks を使用するかどうかを決定し、ファイルを準備します。
- XCF ワーク用の一時ディレクトリーを作成します。
braze-swift-sdk-prebuilt
で、dynamic
ディレクトリを開き、BrazeKit.xcframework
をディレクトリに移動します。ディレクトリは次のようになります。1 2
temp_dir └── BrazeKit.xcframework
- chosen XCFrameworks をそれぞれ一時ディレクトリに移動します。ディレクトリは次のようになります。
1 2 3 4 5
temp_dir ├── BrazeKit.xcframework ├── BrazeKitCompat.xcframework ├── BrazeLocation.xcframework └── SDWebImage.xcframework
ステップ 3.1:フレームワークの準備
- XCF ワーク用の一時ディレクトリーを作成します。
braze-swift-sdk-prebuilt
でstatic
ディレクトリを開き、BrazeKit.xcframework
をディレクトリに移動します。ディレクトリは次のようになります。1 2
temp_frameworks_dir └── BrazeKit.xcframework
- chosen XCFrameworks をそれぞれ一時ディレクトリに移動します。ディレクトリは次のようになります。
1 2 3 4 5
temp_frameworks_dir ├── BrazeKit.xcframework ├── BrazeKitCompat.xcframework ├── BrazeLocation.xcframework └── SDWebImage.xcframework
ステップ 3.2:バンドルの準備
- バンドルの一時ディレクトリを作成します。
bundles
ディレクトリを開き、BrazeKit.bundle
をディレクトリに移動します。ディレクトリは次のようになります。1 2
temp_bundles_dir └── BrazeKit.bundle
BrazeLocation
、BrazeUI
、BrazeUICompat
、またはSDWebImage
XCFrameworks を使用している場合は、対応するバンドルを一時ディレクトリに移動します。ディレクトリは次のようになります。1 2 3 4 5
temp_bundles_dir ├── BrazeLocation.bundle ├── BrazeUI.bundle ├── BrazeUICompat.bundle └── SDWebImage.bundle
準備したフレームワークのバンドルの上のみ移動します。
ステップ 4: フレームワークの統合
次に、Dynamic またはStatic XCFrameworks you prepared before を統合します。
Xcode プロジェクトで、ビルドターゲットを選択し、General を選択します。Frameworks, Libraries, and Embedded Contentの下で、前に準備した[ファイルをドラッグ&ドロップします。
GIF サポートを有効にするには、braze-swift-sdk-prebuilt/dynamic
にあるSDWebImage.xcframework
を追加します。
Xcode プロジェクトで、ビルドターゲットを選択し、General を選択します。Frameworks, Libraries, and Embedded Contentの下で、前に準備した[フレームワークをドラッグ&ドロップします。各フレームワークの横にある埋め込まないを選択します。
GIF サポートを有効にするには、braze-swift-sdk-prebuilt/static
にあるSDWebImage.xcframework
を追加します。
ビルドターゲットで、ビルドフェーズ を選択します。Copy Bundle Resourcesの下で、前に準備した[バンドルをドラッグ&ドロップします。
Objective-C プロジェクトの一般的なエラー
Xcode プロジェクトにObjective-C ファイルのみが含まれている場合は、” missing symbol” errors with your build your project.これらのエラーを修正するには、プロジェクトを開き、空のSwift ファイルをファイルツリーに追加します。これにより、ビルドツールチェーンはSwift Runtime を埋め込み、ビルド時に適切なフレームワークにリンクします。
1
FILE_NAME.swift
FILE_NAME
を空白以外の文字列に置き換えます。ファイルは次のようになります。
1
empty_swift_file.swift