# BillingEasy **Repository Path**: TJHello/BillingEasy ## Basic Information - **Project Name**: BillingEasy - **Description**: 一款全新设计的内购聚合，同时支持华为内购与谷歌内购。 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 25 - **Forks**: 8 - **Created**: 2021-07-18 - **Last Updated**: 2025-07-29 ## Categories & Tags **Categories**: android-modules, payment-dev **Tags**: None ## README # BillingEasy-2.0.4 **QQ交流群(425219113)** --- 免责声明 在使用BillingEasy前，请您务必仔细阅读并透彻理解本声明。您可以选择不使用本程序，但如果您使用了本程序或任何本程序未来的更新，您的使用行为将被视为对以下全部内容的认可。 您可享有法律规定下本程序不得排除或限制的担保、条件和条款。 除了这些不可排除的担保、条件和条款，本程序不作出任何担保、条件、陈述、保证或条款（无论是明示的还是暗示的，也无论是依据成文法、普通法、惯例、常例，还是其他任何原因）， 包括但不限于性能、结果、安全、不侵权、适销性、完整性、可不受干扰使用、质量满意以及适用于任何特殊用途。 1. 该库免费开源，使用该库请遵循Apache License2.0协议。 2. 该库可能存在一定的bug风险以及网络服务中的风险，请在使用过程中经过严格测试，您需要了解并同意，因使用本程序而导致的任何损失，本程序不承担任何责任。 3. 禁止将该库用于法律不允许的场景，该库不对任何使用行为负任何法律责任。 4. 如该协议有更新，我们将直接更新此文本，您可以定期来看。但我们没有义务和责任确保您一定了解到更新的内容，但只要您继续使用该程序，就视为您同意本协议的所有内容。 --- --- 一款全新设计的内购聚合，同时支持华为内购与谷歌内购。 1. 使用了模块化技术，可以实现按需切换平台，而不残留任何平台代码。 2. 重新设计了所有接口，去除了业务相关逻辑，还给大家原生操作。 3. 运用了大量callback，提供更加便捷的即用即回API。 --- --- 谷歌内购提醒([官方文档地址](https://developer.android.com/google/play/billing/billing_reference?hl=zh-cn)) 1. 从 2023 年 8 月 2 日起，所有新应用都必须使用结算库版本 5 或更高版本。自 2023 年 11 月 1 日起，现有应用的所有新版本都必须使用结算库版本 5 或更高版本。了解详情。 2. 如果您的应用以 Android 14 或更高版本为目标平台，您必须更新到 PBL 5.2.1 或 PBL 6.0.1 或更高版本。 --- ### 使用步骤 - ### Step1 添加远程仓库地址-build.gradle(project) ```groovy allprojects { repositories { google() mavenCentral() jcenter() maven {//私人仓库 credentials { username '64902788b97ac8ef224e6817' password '99F9lqriqO4R' } url 'https://packages.aliyun.com/maven/repository/2254835-release-ZGwQoJ/' } maven {url 'https://developer.huawei.com/repo/'}//华为用到 } } ``` - ### Step2 配置-build.gradle(app) ```groovy android{ //支持JAVA8，享受更多的语法糖 compileOptions { sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 } } dependencies { //主SDK implementation 'com.TJHello.easy:BillingEasy:2.0.4-t01'//BillingEasy //谷歌内购适配器(按需选择版本) implementation 'com.TJHello.publicLib.billing:google:5.1.0.204'//(推荐)Google内购(按需添加) implementation 'com.TJHello.publicLib.billing:google:6.0.1.204-t01'//(最新)Google内购(按需添加) implementation 'com.TJHello.publicLib.billing:google:4.0.0.204-t07'//(谷歌方面即将强制报废)Google内购(按需添加) //谷歌和华为适配器不可同时接入 //接入华为支付需要先接入HMS，详情看官方接入文档(https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/dev-process-0000001050033070) implementation 'com.TJHello.publicLib.billing:huawei:6.4.0.301.204-t09'//(推荐)Huawei内购(按需添加)(暂不支持多activity) implementation 'com.TJHello.publicLib.billing:huawei:5.1.0.300.204-t13'//Huawei内购(按需添加)(暂不支持多activity) } ``` - ### Step3 代码示例([MainActivity](https://gitee.com/TJHello/BillingEasy/blob/master/app/src/main/java/com/tjhello/app/easy/billing/MainActivity.java)) ```java public class MainActivity extends AppCompatActivity { private final MyBillingEasyListener billingEasyListener = new MyBillingEasyListener(); @Override protected void onCreate(Bundle savedInstanceState) { BillingEasy.setDebug(true); BillingEasy.addProductConfig(ProductType.TYPE_INAPP_CONSUMABLE,"可消耗商品code","可消耗商品code"); BillingEasy.addProductConfig(ProductType.TYPE_INAPP_NON_CONSUMABLE,"非消耗商品code","非消耗商品code"); BillingEasy.addProductConfig(ProductType.TYPE_SUBS,"订阅商品code","订阅商品code"); ProductConfig productConfig = ProductConfig.build(ProductType.TYPE_INAPP_NON_CONSUMABLE,"test_code","noads");//添加一个带去广告属性的商品 BillingEasy.addProductConfig(productConfig); BillingEasy.addListener(billingEasyListener);//添加完整监听器 BillingEasy.init(this); //查询商品信息-两种用法 BillingEasy.queryProduct(ProductType.TYPE_INAPP_CONSUMABLE); BillingEasy.queryProduct(ProductType.TYPE_INAPP_CONSUMABLE,(billingEasyResult, productInfoList) -> { }); //发起购买 BillingEasy.purchase(this,"商品code"); } //仅华为内购需要调用 @Override protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) { BillingEasy.onActivityResult(requestCode,resultCode,data); } @Override protected void onDestroy() { //多activity情况下注意移除监听器，避免内存泄漏 BillingEasy.removeListener(billingEasyListener); super.onDestroy(); } //以下接口只要支持了JAVA8，都是可选实现 private class MyBillingEasyListener implements BillingEasyListener{ @Override public void onConnection(@NonNull BillingEasyResult result) { //内购服务连接 } @Override public void onDisconnected() { //内购服务断开 } @Override public void onQueryProduct(@NonNull BillingEasyResult result, @NonNull List productInfoList) { //查询商品信息 } @Override public void onPurchases(@NonNull BillingEasyResult result, @NonNull List purchaseInfoList) { //如已开启自动消耗与购买，则不需要手动消耗与确认购买 //购买商品，判断示例 if(result.isSuccess){ for (PurchaseInfo purchaseInfo : purchaseInfoList) { //判断商品是否有效 if(purchaseInfo.isValid()){ for (ProductConfig productConfig : purchaseInfo.getProductList()) { //判断商品类型 String type = productConfig.getType(); if(type!=null){ switch (type){ //内购商品-可消耗 case ProductType.TYPE_INAPP_CONSUMABLE:{ //消耗商品(消耗包括确认购买) BillingEasy.consume(purchaseInfo.getPurchaseToken()); }break; //内购商品-非消耗||订阅商品 case ProductType.TYPE_INAPP_NON_CONSUMABLE: case ProductType.TYPE_SUBS: { //判断是否已经确认购买 if(!purchaseInfo.isAcknowledged()){ //确认购买 BillingEasy.acknowledge(purchaseInfo.getPurchaseToken()); } }break; } } // //或者 // if(productConfig.canConsume()){ // //消耗商品 // BillingEasy.consume(purchaseInfo.getPurchaseToken()); // }else{ // //确认购买 // if(!purchaseInfo.isAcknowledged()){ // BillingEasy.acknowledge(purchaseInfo.getPurchaseToken()); // } // } } } } } } @Override public void onQueryOrder(@NonNull BillingEasyResult result,@NonNull String type, @NonNull List purchaseInfoList) { //查询有效订单(补单逻辑可以在此实现) } @Override public void onQueryOrderHistory(@NonNull BillingEasyResult result,@NonNull String type, @NonNull List purchaseInfoList) { //查询历史订单 } } } ``` - ### API说明 ```java //添加一个商品信息(必须) BillingEasy.addProductConfig( ProductType.TYPE_INAPP_CONSUMABLE,"商品code","商品code"); //查询商品信息 BillingEasy.queryProduct(); BillingEasy.queryProduct((billingEasyResult, productInfoList) -> { }); //发起购买 BillingEasy.purchase(activity,"商品code"); BillingEasy.purchase(activity,param); //查询订单信息 BillingEasy.queryOrderAsync();//联网查询有效订单 BillingEasy.queryOrderLocal();//查询本地缓存订单 BillingEasy.queryOrderHistory();//查询历史订单 //消耗商品 BillingEasy.consume("purchaseToken"); //确认购买 BillingEasy.acknowledge("purchaseToken"); ``` - ### 常见问题 1. 谷歌内购3.0.2以及以上版本要求谷歌商店的版本在:25.8.21以上，已知21.24.18无法购买，升级谷歌商店可到apkpure。 2. reqCode:4,reqMsg:，请检查游戏状态是否正常，检查是否已经添加了测试账号与检查是否加入内测。 - ### 更新日志 2.0.3-t13 2023/03/15 【测试版】 ``` 1、修复华为支付的若干问题 2、修复谷歌支付若干问题 ``` 2.0.3-t06 2023/01/05 【测试版】 ``` 1、修复华为支付的若干问题 2、更换仓库地址 ``` 2.0.3-t03 2023/01/05 【测试版】 ``` 1、增加未初始化的情况的判断，避免在极端情况下的空指针问题 2、补漏个别字段，修复个别接口type不对应的问题 ``` 2.0.3-t01 2022/09/21 【测试版】 ``` 1、支持谷歌内购5.0.0版本 2、个别接口与监听器做了修改 ``` 2.0.2-t01 2022/04/29 【测试版】 ``` 1、删除purchase方法的callback用法。 2、purchase方法添加PurchaseParam参数，支持高级用法需要的参数传递 ``` 2.0.1-t01 2022/04/28 【测试版】 ``` 1、该版本支持了华为内购，API略微改动 2、优化了使用体验 ``` 0.1.2 2022/01/27 ``` 1、queryOrderLocal与queryOrderHistory不生效的问题 2、移除自动查询订单功能，需要查询订单则自行调用queryOrder系列方法 ``` 0.1.2-a02 2021/12/8 ``` 1、修复个别时候在购买成功回调里无法获得商品详情的问题。 ``` 0.1.2-a01 2021/11/26 ``` 1、删除原有的BillingEasy做法，将BillingEasyStatic改名为BillingEasy，采用全静态操作的做法。 ``` 0.1.1-t14 2021/11/23 ``` 1、PurchaseInfo增加getProductInfo方法，可方便获取商品信息。 ``` 0.1.1-t13 2021/10/27 ``` 1、修复自动消耗与自动确认购买的逻辑开关无效的问题 2、修复googleSkuDetails.type没有值的问题 ``` 0.1.1-t12 2021/10/15 ``` 1、添加发起购买的时候，因获取商品信息失败而导致的错误回调 ``` 0.1.1-t11 2021/09/25 ``` 1、添加自动消耗与自动确认购买的逻辑，默认关闭。 ``` 0.1.1-t10 2021/09/16 ``` 1、修复-商品配置信息无法全局动态添加引发的系列的问题。 2、增加-初始化添加链接内购服务器成功的回调 ``` 0.1.1-t09 2021/09/08 ``` 1、添加BillingEasyStatic类，全静态操作 2、去除BillingEasy和BillingManager的免混淆规则 ``` 0.1.1-t08 2021/08/25（存在bug，已删除） ``` 1、添加商品配置自动去重功能 2、添加cleanProductConfig接口，清除所有商品配置 ``` 0.1.1-t07 2021/08/02 ``` 1.修复购买成功接口会多重复回调一次的bug。 ``` 0.1.1-t06 ``` 1.优化商品详情的查询逻辑，避免多余的结果回调。 ``` 0.1.1-t05 ``` 1.修复消耗商品没有传入callback会导致空指针报错的问题。 ```