アプリを構築してテストする
DevKit を使用してアプリを構築し、テストする方法をご紹介します。
SmartPOS DevKit デバイスを使用して、デプロイやアプリの審査、署名のプロセスを実行せずに、アプリケーションを繰り返しテストします。
DevKit デバイスが必要な場合は、ダッシュボードのリーダーセクションから、ユーザーあたり最大 5 台まで注文できます。
DevKit を設定する
DevKit を使用してアプリを開発する前に、以下を実行する必要があります。
- 画面の指示に従ってネットワークに接続します。
- デバイスをお使いの Stripe アカウントに登録します。
- 利用可能なすべての更新をインストールします。
初期設定後に、DevKit を別のアカウントや場所にいつでも登録できます。これを行うには、DevKit をインターネットに接続し、リーダーの登録手順に従います。
本番環境用デバイスと似ていますが、DevKit デバイスは次の点で異なります。
- サンドボックスでのみ操作できます。
- 開発者向けオプションと Android Debug Bridge (
adb
) がデフォルトで有効になっている状態で出荷されます。 - デバイスがテスト専用で使用されていることを示すウォーターマークが画面上に表示されます。このウォーターマークは、デバイスの使用中に画面内を移動するため、ユーザーは画面のすべての部分を確認できます。
Terminal API は、登録済みの DevKit デバイスのターゲット設定をサポートします。
Stripe デバイス向けのアプリを開発する
以下のステップを使用して、Stripe Android デバイス向けのアプリを開発します。これには、アプリの設定と Stripe リーダーアプリへのハンドオフが含まれます。
アプリを構築するクライアント側
Apps on Devices の導入については、以下のガイダンスに従います。
リーダーを検出して接続する
支払いを回収する
ハンドオフモードを使用してリーダーに接続すると、支払いの回収を開始できます。
The Stripe Reader app handles payment collection and other payment operations, such as saving payment details. When initiating a payment operation, the Stripe Reader app becomes the primary and launches in full screen. Then, the Stripe Reader app guides the customer through the flow and returns control to your app after completion (success or failure) or customer cancellation. When control returns to your app, the Stripe Reader app continues to run in the background.
Apps on Devices アプリで支払いを回収する例をご覧ください。
オフライン中に支払いを回収するPreview
Apps on Devices は、オフラインでの支払いの回収をサポートします。
アプリを測定するクライアント側
Stripe は、アプリケーションレベルの測定ソリューションを提供していません。アプリケーションのクラッシュやその他のログを追跡するには、Sentry や Crashlytics などのサードパーティーのライブラリを使用できます。
デバイスのロケールを設定するクライアント側
デバイスユーザーが選択した言語 (国ではなく) は、Locale.getDefault() によって返される値に入力されます。デバイスの言語は管理者設定で変更できます。
画面の向きクライアント側
Stripe Android デバイスでは、_自動回転画面_設定がデフォルトで有効になっています。アプリでは、UI を特定の画面の向きにロックすることで、この設定を上書きできます。
これは、マニフェストで関連する <activity>
タグに screenOrientation 属性を設定することで行えます。
<activity android:name=".MainActivity" android:screenOrientation="portrait"> </activity>
または、Activity
クラスで Activity::setRequestedOrientation を使用して、プログラムで設定することもできます。
制限クライアント側
Stripe Android デバイスでは、戻るボタンやステータスバーなどのシステム UI は表示されません。
アプリが電池残量、充電状態、接続のステータスをユーザーに表示する必要がある場合は、以下の Android API のドキュメントで詳細をご覧ください。
デバイスアクセサリーを扱うクライアント側
Stripe リーダーがドックに接続または切断すると、Android オペレーションシステムは設定の変更をトリガーします。
デフォルトでは、設定が変更されるとアプリのアクティビティーは自動的に再作成されます。
ドックの接続時または切断時にアクティビティーの自動再作成を無効にするには、AndroidManifest.
ファイルの <activity>
エントリーに android:configChanges="uiMode"
を追加します。
<activity android:name=".MyActivity" android:configChanges="uiMode" />
Activity::onConfigurationChanged を実装することにより、アクティビティーで設定変更が通知されるようにすることができます。このメソッドは、マニフェストで android:configChanges
属性で処理する設定を指定している場合にのみ呼び出されます。
class MainActivity : Activity() { override fun onConfigurationChanged(newConfig: Configuration) { super.onConfigurationChanged(newConfig) // implement custom configuration change handling logic } }
アプリをテストする
S700 DevKit デバイスを使用して、Stripe ダッシュボードでアプリをテストするか、Android Debug Bridge (adb
) を使用してアプリをテストします。
支払いをテストする
DevKit デバイスは、ダッシュボードで注文できる Stripe のテスト用の物理カードを使用してテスト支払いを処理できます。支払いをテストする際に、小数を使用する金額を使用して特定の結果を生成することができます。
警告
DevKit デバイスで支払いをテストするときに、実際のカードを使用しないでください。