> 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 | 성공 | 成功 |

| | RESULT\_UNKNOWN | -1 | 알 수 없는 오류가 발생하였습니다. | 出现未知错误 | 请咨询 ONE store | | RESULT\_USER\_CANCELED | 1 | 사용자가 로그인을 취소하였습니다. | 用户取消登录. | 请咨询 ONE store | | RESULT\_SERVICE\_UNAVAILABLE | 2 | 단말 또는 서버 네트워크 오류가 발생하였습니다. | 终端或服务器网络出错 | 请检查网络状态. | | RESULT\_ALC\_UNAVAILABLE | 3 | ALC api 버전 정보가 낮습니다. 해당 라이브러리를 업데이트 해주세요. | ALC api 版本过低。请更新Library | 请将ALC Library 更新到最新版本。 | | RESULT\_DEVELOPER\_ERROR | 5 | 파라메터가 유효하지 않습니다. | 参数无效 | 请咨询 ONE store | | RESULT\_ERROR | 6 | 정의되지 않은 기타 오류가 발생하였습니다. | 发生了其他未定义的错误 | 请咨询 ONE store | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://onestore-dev.gitbook.io/dev/chi/tools/alc/add-alc-library-dependency.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.