开始

本章描述将 Loxily Localize Android SDK 接入到你的应用的三个步骤：先在 Loxily Localize 后台创建应用拿到 App Key，再把 SDK 依赖加到你的 Gradle 项目，最后在 Application 里完成 SDK 初始化。三步完成后即可使用获取词条、切换语言等基础功能。

注册应用信息

在接入 SDK 之前，你需要在 Loxily Localize 开放平台 创建项目并获取以下两项凭证：

• App Key：应用唯一标识，SDK 初始化时需要
• App Secret：用于服务端 API 签名（客户端 SDK 不直接使用，但同一应用共用一份）

登录 Loxily Localize 控制台 → 选择或创建项目 → 进入 集成 / 开放平台 页面 → 复制 App Key 备用。若暂未开通控制台访问，请联系 Loxily 对接人员协助开通。

SDK 接入

在项目的 build.gradle 文件中添加依赖：

dependencies {
  implementation 'com.loxily:android-localize-sdk:1.4.1'
}

注意：

Loxily Localize SDK 使用到的类库有 recyclerView、material、okhttp、gson、glide。

如果有和你项目中重复的库并导致依赖冲突时，请根据具体的构建平台对冲突类库进行排除即可。

接入完成后，接下来就可以初始化 Loxily Localize 了。

初始化

在项目的 Application 类中调用初始化方法：

public class App extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        // SDK 初始化
        LoxilyLocalize.init(
            this,                           // Context
            "YOUR_APP_KEY",                 // AppKey（从后台获取）
            "zh-cn",                        // 目标语言代码
            true,                           // 是否国际化版本（true=海外，false=中国大陆）
            true                            // 环境区分（true=测试，false=正式）
        );

        // 设置初始化回调（可选）
        LoxilyLocalize.setOnTranslationPreparedCallback(
            new OnTranslationPreparedListener() {
                @Override
                public void onDataRetrieved(boolean isSuccess, String errorMsg) {
                    if (isSuccess) {
                        // SDK 初始化成功，可以开始使用
                        Log.d("LoxilyLocalize", "初始化成功");
                    } else {
                        // SDK 初始化失败
                        Log.e("LoxilyLocalize", "初始化失败: " + errorMsg);
                    }
                }
            }
        );
    }
}

参数说明

参数	类型	必填	说明	示例
context	Context	是	应用上下文	this
appKey	String	是	应用唯一标识，从 Loxily Localize 后台获取	"7a0c1ee2622bc85a4030297uo3b"
language	String	是	目标语言代码	"zh-cn", "en", "ja"
isInternationalizing	boolean	是	是否国际化版本（true=海外，false=中国大陆）	true / false
isBuildDebug	boolean	是	环境区分（true=测试，false=正式）	true / false

重要提示：

初始化回调是异步的，请确保在回调成功后再使用 SDK 的其他功能。

---

初始化完成后，请继续阅读 基础功能 了解如何获取词条和切换语言。