# アプリの外部テスト

アプリを公開する前に、テストバージョンを設定して配布することができます。

> 外部テストを利用できるのは、本番環境、サポート対象の Stripe サンドボックス、またはテスト専用アカウントからアップロードされた公開アプリのみです。V1 Connect のテストアカウントでは、外部テストはサポートされていません。

外部テストを使用すると、App Marketplace で新しいバージョンを公開する前に、他のアカウントでアプリをインストールできるようになります。

サンドボックスまたはテスト専用アカウントからアップロードされたアプリの外部テストリンクは、他のサンドボックスまたはテスト専用アカウントでのみ機能し、本番環境では機能しません。これらのアプリでは、標準のインストールリンクは利用できません。

## Before you begin

1. [アプリを作成します](https://docs.stripe.com/stripe-apps/create-app.md)。
2. 必須の[アプリ審査要件](https://docs.stripe.com/stripe-apps/review-requirements.md)を確認します。
3. [アプリをアップロードします](https://docs.stripe.com/stripe-apps/upload-install-app.md)。
4. アプリごとのテスター数は 25 人までに制限されています。外部テストの使用をテストの目的に限定するためです。

## 外部テストを設定する
![テスト用アプリを設定する](https://b.stripecdn.com/docs-statics-srv/assets/test-app-setup.b1dacf8f5ad162d1a72cb26162cbb12a.png)

ダッシュボードでユーザーを招待する

1. \**[開発者ダッシュボード](https://dashboard.stripe.com/developers) > [アプリ](https://dashboard.stripe.com/apps)\**から、外部テストを行うアプリを選択します。
2. **外部テスト**タブをクリックし、**始める**をクリックします。
   - **外部テスト**タブが表示されない場合は、**リリースを作成する**から一般公開を選択していることを確認します。
3. 次のフィールドに入力して、外部テストを設定します (いつでも編集可能です)。
   - **リンクアクセス**: リンクを使用して誰でもアプリをインストールできるようにするか、招待されたユーザーのみに制限するかを選択します。
   - **バージョン**: ユーザーがインストールするバージョンを選択します。バージョンを変更すると、現在のすべてのユーザーに対して新しいバージョンへの更新が行われます。
4. Click the invite link to copy it, and send to users for them to install on their account. These users must have Apps administrator rights to install the app.
   - OAuth を使用するアプリには、本番環境、テスト環境のサンドボックス、一般的なサンドボックス用に個別のインストールリンクがあります。ユーザーには、適切な環境用のリンクを送信してください。

結果: ユーザーがテストバージョンのアプリをインストールすると、アカウントのすべてのメンバーがアプリを使用できるようになります。
![Stripe ダッシュボード内のテスト OAuth リンクの場所](https://b.stripecdn.com/docs-statics-srv/assets/test-oauth-links.caccc199c651d4f1fa4d5dc398a2ccba.png)

## テストアプリのバージョンを更新する

1. \**[開発者ダッシュボード](https://dashboard.stripe.com/developers) > [アプリ](https://dashboard.stripe.com/apps)\**から、外部テストを行うアプリを選択します。
2. **外部テスト**タブをクリックし、**編集**をクリックします。
3. ドロップダウンから新しいバージョンのアプリを選択し、**保存**をクリックします。

結果: 保存すると、現在のユーザーのすべてのテスト用アプリが自動的に新しいバージョンへ更新されます。

## テストアプリを評価する

テスト用アプリは開発中であり Stripe による審査がまだ行われていないことをユーザーに伝える必要があります。ユーザーは信頼できる開発者からのみアプリをインストールします。

### テスト用アプリをインストールする

テスターが招待リンクを開くと、Stripe はテスターを Stripe ダッシュボードの次のページにリダイレクトします。
![インストールの招待](https://b.stripecdn.com/docs-statics-srv/assets/test-app-install.2d67f49c8cafcfb964c9d19ff7cf6d30.png)

インストールの招待

ユーザーがアプリをインストールすると、そのアカウントのすべてのメンバーがアプリを使用できるようになります。公開バージョンのアプリがすでにアカウントにインストールされている場合、テストバージョンをインストールする前に、アンインストールしてください。

### テスト用アプリを使用する

インストールすると、アプリはダッシュボードの右側のドックに表示されます。テスト用アプリを開くと、アプリの名前の横にテストバージョンのバッジが表示されます。このバッジにカーソルを合わせると、アプリやテスト基準についての詳細を確認できます。
![テスト用アプリを使用する](https://b.stripecdn.com/docs-statics-srv/assets/test-app-using.49c64bd7d77b4b76e26ebd6852b40485.png)

ドック内のテスト用アプリ

### テストを終了する

ユーザーがテストの評価を今後行わない場合、**[設定](https://dashboard.stripe.com/settings/apps) > [インストール済みアプリ](https://dashboard.stripe.com/settings/apps)** からアプリをアンインストールする必要があります。公開バージョンのアプリが以前アカウントにインストールされていた場合は、App Marketplace から再インストールできます。
![アプリをアンインストール](https://b.stripecdn.com/docs-statics-srv/assets/test-app-uninstall.710b89177767cff3a7f53de749558d88.png)

設定ページ

### テストを終了する

現在、Stripe ダッシュボードを使用した外部テストの終了には対応していません。代わりに、アプリでテストを終了するには、新しいバージョンのアプリをアップロードして、機能を無効にする必要があります。この更新を行うと、新しいテストバージョンを外部テストに使用できるようになります。

## See also

- [アプリを公開する](https://docs.stripe.com/stripe-apps/publish-app.md)
- [アプリの審査要件](https://docs.stripe.com/stripe-apps/review-requirements.md)