README.md · 不知道伯纳乌/BillingEasy

# 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<ProductInfo> productInfoList) {
            //查询商品信息

}

@Override
        public void onPurchases(@NonNull BillingEasyResult result, @NonNull List<PurchaseInfo> 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<PurchaseInfo> purchaseInfoList) {
            //查询有效订单(补单逻辑可以在此实现)
        }

@Override
        public void onQueryOrderHistory(@NonNull BillingEasyResult result,@NonNull String type, @NonNull List<PurchaseHistoryInfo> 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会导致空指针报错的问题。
```

不知道伯纳乌/BillingEasy

简介

发行版

贡献者

近期动态

不知道伯纳乌/BillingEasy .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

不知道伯纳乌/BillingEasy