Cocos2dx 使用obb扩展包

# APK Expansion Files For Cocos2dx

### 预先要了解的

---

* APK扩展文件：https://developer.android.com/google/play/expansion-files

### Cocos2dx引擎读取obb扩展文件能力

---

1. 从cocos2dx-3.13.1版本开始，引擎实现了对obb扩展文件的读写
2. 较早版本的cocos2d-x引擎需要自已实现，参考文章：https://blog.csdn.net/bibi333/article/details/79794527

如果你使用的引擎版本不支持读取扩展文件，我建议你尽可能的升级引擎，避免自行修改引擎代码。

### 本地测试扩展文件
在将游戏程序上传到Google Play之前，你应该测试应用程序从共享存储中读取文件的能力。你需要将制作好的扩展文件添加到设备共享存储上适当位置，然后启动游戏程序。

1. 制作obb扩展文件包：
     `zip -rn .ogg:.mp3:.wav ../main.1.org.cocos2dx.testobb.obb ./asset/`
2. 预先安装好游戏后，再将扩展文件拷贝到：Android/obb/yourpackagename/
3. 注意事项：
    * 在拷贝到真机之前，需要解压扩展文件，来查看目标结构是否正确，文件是否完整
    * 需要确认扩展文件的名称是否符合规则，版本号是否正确
    * 需要手动创建对应你游戏程序的扩展文件目录

按照以上步骤执行，完成对扩展文件的本地测试。

### 测试文件下载

1. 稳定的VPN环境，推荐Astrill，访问官方网站：https://www.astrill-china.com 
2. 谷歌开发者帐号
3. 登陆Google Play Console，创建应用：https://play.google.com/apps/publish/
4. 创建Alpha版/Beta版，添加内部测试渠道，然后发布
5. 注意事项：
    * 国内的测试环境很不友好，你需要一部安装有Google服务框架、Google Play服务的Android手机
    * 你需有稳定的VPN环境，以避免出现一些不可预见的问题，比如测试过程中卡死等现象
    * 国内申请谷歌开发者帐号比较困难，请自行解决了

经历以上步骤，你成功发布了测试版本，但通常你不能立即在Google Play商店搜索到他，Alpha版本相对快一些，通常需要等待2~6小时。

### 检查下载到本地的扩展文件、下载丢失的扩展文件、校验扩展文件
在Google Play商店下载测试版本，下载过程中会将扩展文件下载到Android/obb/yourpackagename/目录，为了保证扩展文件完整性，你需要对扩展文件进行检查、重新下载、校验等工作。

1. 通过将许可证验证库和下载程序库添加到你的游戏程序中，以集成从Google Play下载扩展库的功能
2. 实现下载扩展文件和校验扩展文件的UI展示以及相关的逻辑功能
3. 实现Andorid的Activity和Cocos2dxActivity之间的切换

启动游戏程序后，你应该确保本地扩展文件的完整性和有效性，检查通过后才能切换到Cocos2dxActivity进行正常的游戏启动流程。