Play Billing Libraryの更新は今「8以上」が必須|purchases_flutterの上げ方と期限

このページには広告が含まれる場合があります。

 

※この記事は、2026年11月時点の情報です(公式の情報は2026年11月15日に確認しました)。Google Play の期限は毎年動くので、作業の前に公式のページも見ておいてください。

Play Console を開いたら、Google Play Billing Library のバージョンが古い、という警告が出ている。

去年も同じようなことを言われた気がして、「また上げなあかんの!?」と思った方もいるんじゃないでしょうか。

先に答えを書くと、2026年11月の今、課金の入ったアプリは、Google Play Billing Library(課金のライブラリ)がバージョン8以上でないと、新しいアプリもアップデートも出せません。 バージョン7に許されていた延長の期限(2026年11月1日)も、もう過ぎています。

Flutter で RevenueCat の purchases_flutter を使っているなら、purchases_flutter を 9.0.0 以上に上げれば、中の Billing Library が8になります。 11.0.0 以上なら、中は9です。

ぼくも Flutter で作った自分のアプリを、出したあとも運営していて、アプリによっては課金も入れています。アプリは、ストアに出したら終わりではありません。こういう「期限つきの宿題」が、毎年のように回ってくるんです。

この記事では、期限の表の読み方と、purchases_flutter の上げ方、上げたあとに止まりやすい所を、公式の情報に沿ってまとめます。

 

Play Billing Library には「2年の期限」がある

まずは公式の情報から見ていきます。

公式のページには、Google Play Billing Library のどのバージョンにも、2年の非推奨のサイクルがある、と書かれています。新しいバージョンは、ほぼ毎年出ます。出てから2年ほどたった版は、新しいアプリやアップデートに使えなくなる、という流れなんです。

ページにある期限の表を、日本語にするとこうなります。

バージョン新しいアプリ・アップデートの期限延長の期限
52024年8月31日2024年11月1日
62025年8月31日2025年11月1日
72026年8月31日2026年11月1日
82027年8月31日2027年11月1日
92028年8月31日2028年11月1日

表の読み方は、「その日を過ぎると、そのバージョンのままでは、新しいアプリもアップデートも出せない」です。

つまり、2026年11月15日の今は、バージョン7の延長の期限まで過ぎているので、8か9でないと出せないということなんです。8で上げた場合は、次の期限が2027年8月31日。9なら2028年8月31日まで持ちます。

公式のページには、ほかにこんなことも書かれています。

  • この依存関係が入るのは、課金の権限(com.android.vending.BILLING)を使うアプリだけ。課金のないアプリには関係ない
  • もう手を入れていないアプリは、上げなくてもいい。今入っているアプリは、そのまま動く。新しく出すアプリとアップデートだけが、対象のバージョンを使う必要がある
  • 対象外のバージョンを使っていると、Play Console に警告が出る。延長のフォームは、「Policy status」のページの、その警告の詳細から開く

延長のフォームは、2026年11月1日を過ぎた今、バージョン7のためには使えません。今からは、上げるしかないんです。

ちなみに、Google Play Billing Library の新しい版は、9.0.0 が2026年5月19日、9.1.0 が2026年6月18日に出ています(リリースノートより)。

対象 API レベルの期限と、同じ日付で動いている

この「8月31日が期限、11月1日まで延長」という形、どこかで見覚えがありませんか。

Android アプリの対象 API レベル(targetSdk)の要件も、同じ日付で動いています。Play Console ヘルプには、こう書かれています。

2026 年 8 月 31 日以降: 新しいアプリとアプリのアップデートを Google Play に送信する場合は、Android 16(API レベル 36)以降を対象にする必要があります。

延長も、同じ2026年11月1日までです。課金のライブラリも、API レベルと同じで、期限までに少しずつ上げていく必要がある、と覚えておくとわかりやすいと思います。

(API レベルそのものについては、こちらの記事でも書いています。少し前の記事なので、数字は今のものではありません)

 

Flutter では、purchases_flutter を上げれば中身も上がる

公式のページには「build.gradle の依存関係を、表のバージョンに上げてください」とあります。

ただ、Flutter で purchases_flutter を使っている場合、Billing Library は自分の build.gradle には書かれていません。purchases_flutter の中にある RevenueCat の Android の SDK が、Billing Library を連れてきているんです。

だから、Flutter で上げるのは、Billing Library そのものではなく、purchases_flutter の方になります。

purchases_flutter の変更履歴(pub.dev・GitHub のリリースノート)で、どの版がどの Billing Library を使っているかを確かめると、こうなっていました。

purchases_flutter中の Billing Library気をつけること(リリースノートより)
9.0.0〜8Flutter 3.22.0・Dart 3.4.0 以上が必要
10.0.0〜8.3.0対応する Android の最小が Android 6(API 23)に上がった(それまでは 21)
11.0.0〜9.1.0Kotlin 2.2 を使う。同じアプリのほかの課金のプラグインも、Billing Library 9 に対応している必要がある

2026年11月15日の時点で、pub.dev の最新は 11.0.2 です。10系にも、まだ直しの版が出ています。

今の期限(8以上)を満たすだけなら、9.0.0 以上ならどれでも足ります。 ただ、どうせ手を入れるなら、11系(Billing Library 9)まで上げておくと、次の宿題が2028年まで来ません。

RevenueCat は、道具の進み方が早いんです。2025年の講座で課金の設定を見せていたとき、ストアに登録した課金アイテムを、RevenueCat の画面からインポートのボタン1つで取り込めるようになっていて、「すげえな、今こんなんなってんねん、感激や」と声が出たことがあります(「僕だけ感動してますけど」とも言いました)。そのぶん、上げるたびに中身も変わるので、変更履歴を読んでから上げるのがおすすめです。

(purchases_flutter を入れると課金の権限がどう入るかは、こちらの記事でも書いていますので、よろしければご覧ください)

 

purchases_flutter の上げ方

順番に並べると、こうなります。コマンドの出方や画面は、環境によって異なります。

  1. 今の版を確かめる:プロジェクトのフォルダで flutter pub outdated を実行し、purchases_flutter の「Current」(今入っている版)と「Latest」(最新)を見る。pubspec.lock に書かれた版でもわかります
  2. 上げる前に、今の状態を残しておく:Git を使っているならコミットしておく。うまくいかなかったときに戻れるようにするためです
  3. 越える大きな版の、移行の案内を読む:8系から11系へ上げるなら、9.0.0・10.0.0・11.0.0 のリリースノートと、11系の移行ガイド(v11 Migration Guide)に目を通す。Dart のコードの書き方が変わる所もあります
  4. pubspec.yaml の版を書き換える:たとえば purchases_flutter: ^11.0.2 のようにして、flutter pub get を実行する
  5. Android の設定を、案内に合わせて直す:Kotlin・compileSdk・minSdk(下の「上げたあとに止まりやすい所」)
  6. App Bundle を作り、課金の版を確かめる:flutter build appbundle が通ったら、Android Studio で android フォルダを開き、AndroidManifest.xml の下の「Merged Manifest」のタブで、com.google.android.play.billingclient.version の行を見る。ここに、入っている Billing Library の版が出ます
  7. 内部テストで、実機で買ってみる:内部テストのトラックに上げ、ライセンステスターのアカウントで、購入と購入の復元を一通り試す
  8. 本番のアップデートとして出す

6の確かめ方は、公式のページの「上げたのに警告が消えない」ときの答えにも出てきます。上げたはずなのに警告が残っているときは、まずマニフェストにこの名前があるかを見て、なければ、マニフェストを1つにまとめるときに消されていないかを確かめてください、と書かれています。

なお、dart pub upgrade --major-versions を使うと、大きな版の上げと pubspec.yaml の書き換えをまとめてやってくれます(dart.dev より)。ただ、ほかのパッケージまで一気に上がるので、課金のライブラリだけを狙って上げるなら、4のように手で書き換える方が、何が変わったかを追いやすいと思います。

 

上げたあとに止まりやすい所

大きな版を越えると、たいていはどこかで一度止まります。リリースノートと移行ガイドに書かれている所を、先に並べておきます。

Kotlin が古いと、Android のビルドが通らない

11系の移行ガイドでは、Kotlin 2.1.0 以上が必要とされています。古い Kotlin のままだと、「Module was compiled with an incompatible version of Kotlin」のようなエラーで、ビルドが止まります。直す場所は、android/settings.gradle(または settings.gradle.kts)の Kotlin のプラグインの版です。

(このエラーが出たときのことは、こちらの記事でも書いています。少し前の記事なので、直す場所は今と違うことがあります)

compileSdk を 35 にする必要がある(古い Flutter のとき)

11系は、API 35 でビルドすることが前提です。移行ガイドには、Flutter 3.27 より前の版は compileSdk の既定が34なので、android/app/build.gradle に compileSdk = 35 を自分で書くように、とあります。minSdk と targetSdk は、11系では変わりません。

10系から、Android 6 より古い端末は外れる

10.0.0 から、対応する Android の最小が Android 6(API 23)になりました。minSdk を21や22にしていたアプリは、上げると Android 5 の端末には出せなくなります。

使い切りの課金アイテムの復元が変わった

Billing Library 8 では、期限の切れたサブスクや、使い切った(消費した)1回きりの購入を問い合わせる仕組みがなくなりました。purchases_flutter のリリースノートでも、9.0.0 でそのことが書かれ、10.0.0 では、使い切りの購入を復元するための回り道もなくなっています。

ログインの仕組みがないアプリでは、1回きりの課金アイテムが「消費型」「非消費型」のどちらで設定されているかを、RevenueCat のダッシュボードで確かめておくように、とされています。ずっと使える買い切りのつもりのアイテムが「消費型」になっていると、購入が消費されてしまう、という注意です。

ほかの課金のプラグインも、同じ版に

11系では、同じアプリの中にほかの課金のプラグインがあるなら、それも Billing Library 9 に対応している必要があります。古い API(SkuDetails など)を使っている版だと、ビルドのときか動かしたときに失敗する、と移行ガイドに書かれています。

ビルドが通らないときは、組み合わせを疑う

Kotlin・Gradle・Android Gradle Plugin・compileSdk は、どれか1つを上げると、ほかとの組み合わせでエラーが出ることがあります。

(バージョンの組み合わせで Gradle のエラーが出たときの見分け方は、こちらの記事でまとめていますので、よろしければご覧ください)

こういうエラーで、前のぼくは、エラーメッセージをググっては、ああでもないこうでもないとやって、1つのエラーで半日、1日つぶれることもありました。

今は、AI と組んで仕事を組み立てるようになって、そこがまるで変わりました。「ものの1分もあればエラーも特定してくれるし」という感じです。

どこを目指すアプリにするか、という方向は、ぼくが決めています。答えを出すのは AI が強い。何を目指すかは人が決める。そういう分け方なんです。

(AI と組んで仕事をする中で気づいたことは、あすとろサイコロの記事でも書いていますので、よろしければご覧ください)

 

上げたあとのビルドエラーで止まったら

課金のライブラリを上げるのは、pubspec.yaml の1行でも、そこから Kotlin・Gradle・compileSdk と組み合わせが絡んでくると、ひとりでほどいていくのは、けっこう骨が折れますよね。期限が過ぎて、アップデートが出せないまま、という状態ならなおさらです。

ぼくがやっている60分の相談では、Zoom の画面共有で、止まっているビルドエラーをリアルタイムに一緒に解いていきます。会社の経費で頼みたい方には、見積書・請求書もお出しできます。

よろしければ、お気軽にご相談ください。

 

まとめ

参考:Play Billing Library version deprecation・Google Play Billing Library release notes(Android Developers)、Google Play アプリの対象 API レベルに関する要件(Play Console ヘルプ)、purchases_flutter の Changelog・Versions(pub.dev)、purchases-flutter のリリース 9.0.0・10.0.0・11.0.0・v11 Migration Guide(RevenueCat・GitHub)、dart pub upgrade(dart.dev)。いずれも2026年11月15日確認。

何かのお役に立てれば幸いです。

  • Google Play Billing Library には、2年の非推奨のサイクルがある。期限は毎年8月31日、延長は11月1日まで
  • 2026年11月15日の時点では、バージョン7の延長の期限(2026年11月1日)も過ぎ、新しいアプリもアップデートもバージョン8以上が必要
  • 8の期限は2027年8月31日、9の期限は2028年8月31日
  • 対象になるのは、課金の権限(BILLING)を使うアプリだけ。手を入れていないアプリは、そのまま動く
  • 対象 API レベルの要件(2026年8月31日から API 36)も、同じ日付で動いている
  • Flutter では、Billing Library ではなく purchases_flutter を上げる。9.0.0 以上で中は8、11.0.0 以上で中は9
  • 上げる前に、越える大きな版のリリースノートと移行ガイドを読む。Kotlin 2.1.0 以上・compileSdk 35(11系)、最小 Android 6(10系から)に気をつける
  • 使い切りの課金アイテムの復元が変わったので、RevenueCat で消費型・非消費型の設定を確かめる
  • 上げたら Merged Manifest の com.google.android.play.billingclient.version で版を確かめ、内部テストで購入と復元を試してから出す

アプリのリリースでお困りですか?
Google Play・App Storeへのリリース支援サービスをご用意しています。
ビルドエラー解決・動作確認・申請代行まで、現役開発者が対応します。

みんプロ式・アプリ開発支援サービス一覧を見る ↗

こんな記事も読まれています

【無料】生年月日を入力するだけ!

あなたの知らない「あなた」がわかる
無料診断ツール

あすコロ式
使命・性格タイプ診断

生年月日を入力するだけで144通りの性格パターンを診断。あなたの知らない「本当のあなた(生きる目的・使命)」と「偽りのあなた(無意識の思いグセ)」がわかります!

今すぐ無料で診断する ▶

TOP