> For the complete documentation index, see [llms.txt](https://onestore-dev.gitbook.io/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onestore-dev.gitbook.io/dev/chi/tools/alc/add-alc-library-dependency.md). # Add ALC library dependency ### 添加 ALC Library 从属项目项目顶端 build.gradle 文件中，注册 ONE store maven 地址。 Android Studio (version: bumblebee) 中添加 settings.gradle hljs.highlightAll(); ```gradle ... buildscript { repositories { ... maven { url 'https://repo.onestore.net/repository/onestore-sdk-public' } } } ... ```
下面应用软件的 build.gradle 文件中，添加 ONE store ALC Library从属项目 hljs.highlightAll(); ```gradle ... dependencies { def onestore_sdk_version = "2.0.0" implementation "com.onestorecorp.sdk:sdk-licensing:$onestore_sdk_version" } ... ``` ### AndroidManifest.xml中添加queries 以下两种情况，请参考ONE store 公告进行设置。 * [Target SDK 版本设置为 30(OS 11) 以上](https://dev.onestore.co.kr/devpoc/support/news/noticeView.omp?pageNo=4\¬iceId=32968\&viewPageNo=\&searchValue=) * [Target SDK 版本设置为31(OS 12) 以上](https://dev.onestore.co.kr/devpoc/support/news/noticeView.omp?pageNo=1\¬iceId=33072\&viewPageNo=\&searchValue=)
Android 11 以上 (Target SDK 30 以上) ，请添加 queries。 hljs.highlightAll(); ```xml ... ``` ### 为ONE store Login添加configuration 项目顶端build.gradle 文件中注册 maven 地址添加ALC Library从属项目时，流程同上。 hljs.highlightAll(); ```gradle ... buildscript { repositories { ... maven { url 'https://repo.onestore.net/repository/onestore-sdk-public' } } } ... ``` 下面应用软件的 build.gradle 文件中，添加添加 ONE store configuration Library从属项目。 hljs.highlightAll(); ```gradle ... dependencies { def onestore_configuration_version = "1.0.0" implementation "com.onestorecorp.sdk:sdk-configuration-kr:$onestore_configuration_version" } ... ```
### AppLicenseChecker 初始化使用Application License Checke 要求用户的购买许可证，需生成AppLicenseChecker的 instance。\ 必须通过开发者中心颁发的许可证密钥来验证许可证。此外，是否拥有有效许可证的结果是通过 LicenseCheckerListener 传递的，初始化时需创建Listener。 **保存许可证密钥** 为了安全起见，建议通过服务器接收许可证密钥并使用，而不是保存在应用程序内代码。 {% tabs %} {% tab title="Kotlin" %} ```java override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) ... val appLicenseChecker = AppLicenseChecker.get(this@MainActivity, getString(R.string.publick_key, new AppLicenseListener()) } ... inner class AppLicenseListener : LicenseCheckerListener { override fun granted(license: String, signature: String) {} override fun denied() {} override fun error(code: Int, message: String) {} } ``` {% endtab %} {% tab title="Java" %} ```java @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); ... appLicenseChecker = AppLicenseChecker.get(MainActivity.this, getString(R.string.publick_key, new AppLicenseListener()); } ... private class AppLicenseListener implements LicenseCheckerListener { @Override public void granted(String license, String signature) {} @Override public void denied() {} @Override public void error(int code, String message) {} } ``` {% endtab %} {% endtabs %} ### Callback 注册 AppLicenseChecker 初始化时，必须注册 LicenseCheckerListener\ LicenseCheckeerListener 是为确认许可验证而提供的接口。许可验证结果调用 LicenseCheckeerListener 方法之一。\ granted()、denied() 、error()三种方法，可进行简单的结果处理。 error() 类型传递错误代码和消息。有关错误代码，请参考下面的响应代码。 {% tabs %} {% tab title="Kotlin" %} ```java class AppLicenseListener : LicenseCheckerListener { override fun granted(license: String, signature: String) { // 许可证验证成功 } override fun denied() { // 许可证验证失败 } override fun error(code: Int, message: String) { // 许可证验证出错 } } ``` {% endtab %} {% tab title="Java" %} ```java class AppLicenseListener implements LicenseCheckerListener { @Override public void granted(String license, String signature) { // 许可证验证成功 } @Override public void denied() { // 许可证验证失败 } @Override public void error(int code, String message) { // 许可证验证出错 } } ``` {% endtab %} {% endtabs %} ### 许可证验证请求调用许可证验证时，通过与 ONE store 服务器的通信传递许可证。用户因网络故障或飞行模式等原因无法正常访问ONE store服务器时，一般采使用缓存策略，保证缓存License有效期内应用软件的正常运行。如果不想使用缓存策略，可通过 **strictQueryLicense API** 不使用缓存的许可证。 #### QueryLicense API (Cached API) 调用协同缓存策略操作。一般情况下，通过ONE store服务器接收用户购买历史的License，但因网络故障或飞行模式等原因无法访问ONE store服务器时，使用本地缓存的License来保证有效期内的正常运行。 {% tabs %} {% tab title="Kotlin" %} ```java appLicenseChecker.queryLicense() ``` {% endtab %} {% tab title="Java" %} ```java appLicenseChecker.queryLicense(); ``` {% endtab %} {% endtabs %} #### StrictQueryLicense API (Non-Cached API) 调用不使用缓存的许可证。如果在网络故障或飞行模式下使用该 API，因为无法访问 ONE store 服务器，用户无法使用应用程序。 {% tabs %} {% tab title="Kotlin" %} ```java appLicenseChecker.strictQueryLicense() ``` {% endtab %} {% tab title="Java" %} ```java appLicenseChecker.strictQueryLicense(); ``` {% endtab %} {% endtabs %} ### 断开连接建议通过调用AppLicenseChecker的destroy函数，断开ONE store服务。 {% tabs %} {% tab title="Kotlin" %} ```java override fun onDestroy() { if (null != appLicenseChecker) { appLicenseChecker.destroy() } super.onDestory() } ``` {% endtab %} {% tab title="Java" %} ```java @Override protected void onDestroy() { if (null != appLicenseChecker) { appLicenseChecker.destroy(); } super.onDestory(); } ``` {% endtab %} {% endtabs %} #### 响应代码下表是从 ONE store ALC Library传递到应用程序的Error响应代码和消息。使用Library的应用程序必须处理响应代码。 | Response Code | Value | Description(KR) | Description(CN) | How to handle Solutions | | ------------------------------ | ----- | ----------------------------------------- | ------------------------------------ | ----------------------- | | RESULT\_OK | 0 | 성공 | 成功 |