# アプリのバージョンとリリースを管理する

アプリの新しいバージョンを公開して長期的に変更を管理するためのアプリのバージョン管理とリリースについてご紹介します。

Stripe Apps では、「バージョン」は、アプリの変更を経時的に管理するためのフレームワークです。「リリース」は、アプリの審査に合格した後、自身のアカウントまたは *Stripe App Marketplace* (A marketplace to browse, search, and install Stripe apps) に公開するアプリのバージョンです。

## バージョンの概要

*アプリマニフェスト* (In a Stripe App, the app manifest is a stripe-app.json file in your app's root directory. It defines your app's ID, views, permissions, and other essential properties)の `version` プロパティーではアプリのバージョンを指定できます。Stripe はアプリに特定のバージョン管理スキーマを強制することはありませんが、[セマンティックバージョニング](https://semver.org/)などの確立されたパターンに従うことをお勧めします。

アプリをインストールする Stripe ユーザーは、バージョン番号について考える必要はありません。Stripe は、アプリの最新リリースに自動的にアップグレードします。アプリは、携帯電話のアプリの自動更新と似ています。唯一の例外は権限の範囲が変更される場合です。権限を変更すると、ユーザーはアプリと新しい権限を再度認証するように求められます。

## 新しいアプリバージョンをアップロードする方法

1. [アプリのマニフェスト](https://docs.stripe.com/stripe-apps/reference/app-manifest.md)の `version` プロパティを変更します。
2. 新しいアプリバージョンを Stripe にアップロードします。アプリの作成時と同様の[アップロードプロセス](https://docs.stripe.com/stripe-apps/upload-install-app.md)を実行します。

## テスト環境でアプリバージョンを切り替える

リリースを作成する前に、テスト環境と*サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)環境でアプリバージョンを切り替えることができます。

1. Stripe ダッシュボードで、[アプリ](https://dashboard.stripe.com/apps)に移動します。
2. 新しいバージョンを作成するアプリを選択して、**アプリの詳細**を表示します。
3. バージョン履歴の表で、新しいバージョンのオーバーフローメニュー (⋯) をクリックします。
4. **テスト環境でインストールする**を選択し、 インストールを完了します。

## リリースの概要

本番環境でユーザーにアプリを配布するには、新しいリリースを作成します。アプリを自身のアカウントまたは [App Marketplace](https://docs.stripe.com/stripe-apps/publish-app.md) に公開することができます。App Marketplace に掲載するには、リリースが[アプリの審査](https://docs.stripe.com/stripe-apps/review-requirements.md)に合格する必要があります。

## 新しいリリースを作成する方法

1. Stripe ダッシュボードで、[アプリ](https://dashboard.stripe.com/apps)に移動します。
2. 新しいバージョンを作成するアプリを選択して、**アプリの詳細**を表示します。
3. **新しいリリースを作成する**をクリックします。
4. 新しいリリースを作成するための手順に従います。

リリースがアプリの審査に合格すると、すべてのユーザーが最新リリースのバージョンに自動的にアップグレードされます。

## アプリリストの削除またはリリースの変更方法

アプリのリリースは前方修正のみが可能です。アプリリストの削除、または誤って変更されたアプリのリリースを変更するには、アプリのバージョンを上げて新しいリリースを作成します。

Stripe ではバージョン管理構造を強制していないため、増分リリースは、現在の本番環境のバージョンの後に作成されたリリースになります。たとえば、バージョン 2.0.0 がバージョン 1.0.0 より前にアップロードされた場合、バージョン 2.0.0 ではリリースを作成できません。

Stripe からアプリまたはアプリのリリースを削除するには、[App Marketplace 契約](https://stripe.com/legal/app-marketplace-agreement)の規約、特に「テイクダウン」セクションに従って Stripe にお問い合わせください。

## アプリ権限の更新がアプリユーザーに与える影響

権限を変更したアプリのバージョンをリリースすると、アプリのユーザーは新しい権限を承認して再承認する必要があります。必要な権限なしでアプリがアクションを実行しようとすると、Stripe は「無効なリクエスト」エラーを返します。

特定のアクセス権と、アクセス権によって制御される機能の詳細については、[アクセス権リファレンス](https://docs.stripe.com/stripe-apps/reference/permissions.md)を参照してください。

アプリが再オーソリを必要とする場合、Stripe はメールおよびダッシュボードでユーザーに通知します。
![アプリの再オーソリ通知](https://b.stripecdn.com/docs-statics-srv/assets/app-detail-reauth.18c8b4edc12f85d66af7ad3b2d9ae510.png)

アプリの再オーソリ通知
![アプリの再認証フロー](https://b.stripecdn.com/docs-statics-srv/assets/app-modal-reauth.37afad3db136c57e84e1c1f3ab3d6287.png)

新しい権限のオーソリ

## See also

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