iOS

Push Provisioning SDK は、Apple Pay のプッシュプロビジョニング向けに iOS をサポートしています。

前提条件

• iOS 13.0 以降

• Xcode 14.0 以降

• Swift 5.0 以降

• Apple Pay のすべての機能を利用するには、実機で実行してください。

• 本番テストは、本番デバイスの本番環境で、Ad Hoc プロビジョニングプロファイル、TestFlight、または App Store を使用して実施します。プレプロダクションテストは Xcode から実施します。

プッシュプロビジョニングへのアクセス

Apple Pay のプッシュプロビジョニングには、次の特別な Apple エンタイトルメントが必要です com.apple.developer.payment-pass-provisioning。リクエストするには、次の宛先にメールを送信してください [e-mail].

メールには、次の情報を含めてください：

• アプリ名。

• Apple Developer Membership で確認できる、あなたの Developer Team ID。 Apple Developer Membership.

• ADAM ID（アプリの一意の数値 ID）。App Store Connect またはアプリにリンクされた App Store で確認できます。たとえば、 https://apps.apple.com/app/id123456789.

Apple がエンタイトルメントを付与したら、配布用エンタイトルメントをプロビジョニングプロファイルに追加します。Xcode でアプリを開発する際は、同じプロファイルを使用してください。

プロジェクトでエンタイトルメントファイルを開くか作成し、 com.apple.developer.payment-pass-provisioning キーに Boolean 値 YES.

を追加します。次に、アプリターゲットで、 ビルド設定 > 署名 > コード署名エンタイトルメントへ移動し、それがエンタイトルメントファイルを指していることを確認します。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>com.apple.developer.payment-pass-provisioning</key>
    <true/>
  </dict>
</plist>

また、 アプリ内プロビジョニング 機能をアプリ設定に追加します：

アプリ内プロビジョニング機能を追加します。

Apple Pay の設定方法の詳細については、次を参照してください Apple Pay の設定.

Push Provisioning SDK の統合

1. Push Provisioning SDK の最新リリースをダウンロードし、ZIP ファイルを展開します。

2. Xcode プロジェクトフォルダに移動し、新しいフォルダ「TPCSDK」を作成します。

3. 展開した TPCSDKSwift.xcframework をそのフォルダに配置します。

4. アプリターゲットで、 一般 > フレームワーク、ライブラリ、埋め込みコンテンツ に移動し、+ > その他を追加 > ファイルを追加をクリックします.

5. 次を選択し、 TPCSDKSwift.xcframework をクリックして 開く.

XCFramework をアプリのターゲットに追加します。

〜であることを確認してください 埋め込みと署名 次のように選択されていることを確認してください:

フレームワークを［埋め込みと署名］に設定します。

Objective-C プロジェクトを使用している場合は、 フレームワーク検索パス および ヘッダー検索パス.

フレームワーク検索パスを設定します。

ヘッダー検索パスを設定します。

Swift

構成

Push Provisioning SDK を使用するには、次の構成をアプリケーションに追加してください。

をインポートする TPCSDKSwift あなたのモジュール内の AppDelegate.swift:

TPCSDKSwift をインポート

Objective-C

注意

Xcode のバグにより、プロジェクト内に少なくとも 1 つの Swift ファイル（空でも可）を作成する必要があります。これを Build Phases > Compile Sources.

Push Provisioning SDK をあなたの application:didFinishLaunchingWithOptions: デリゲート関数。

Swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // アプリケーション起動後のカスタマイズ用のオーバーライドポイント。
 
    let tpcイシュアId = "TPC_ISSUER"
    do {
      try TPCSDK.configure(variant: .PPROD,
                          発行者ID: tpcIssuerId)
      // Apple Pay とプロビジョニングがサポートされています
    } catch {
      // TPCErrorを処理
    } 
    
    true を返す
  }

Objective-C

注意

PKPassLibrary のすべての操作（isCardDigitized、getCardDigitizationResult、activatePass、...）はスレッドセーフではありません。単一のスレッドで実行してください。 https://developer.apple.com/documentation/passkit/pkpasslibrary