Sailor 后下载使用说明

客户端开关配置

基于 pyramid 插件实现 ISwanSailor 接口

@Service
@Singleton
public class SwanSailorImpl implements ISwanSailor {
    /**
     * 是否使用预置Sailor，可根据实际情况返回结果
     */
    @Override
    public boolean isSailorPreset() {
        return true;
    }
    /**
     * Sailor是否安装，不要修改此方法实现
     */
    @Override
    public boolean isSailorInstalled() {
        return isSailorPreset() || SwanSailorConfig.isSailorCoreInstalled();
    }
    /**
     * 安装Sailor，不要修改此方法实现
     *
     * @param listener 安装结果回调
     */
    @Override
    public void installSailorCore(final SwanSailorInstallListener listener) {
        SwanSailorCoreInstaller.get().addListener(new OnInstalledListener() {
            @Override
            public void onSuccess() {
                listener.onSuccess();
            }
            @Override
            public void onFail() {
                listener.onFail();
            }
            @Override
            public void onProgress(long current, long sum) {
                listener.onProgress(current, sum);
            }
        }).tryInstall();
    }
}

使用预置方式

• 方法SwanSailorImpl#isSailorPreset 返回 true
• lib-swan-core Module添加依赖 deps.swan.sailor_so（sailor_so Module 包含了需要的 so 文件）

使用后下载方式

• 方法SwanSailorImpl#isSailorPreset 返回 false
• 在SwanDownloadUrlConfig#buildGetSailorUrl()方法中返回实际的后下载地址，此地址需要宿主方根据后下载协议实现Server逻辑。
• 应用覆盖安装升级后，如果有更新 Sailor 的需要，需要在检测到应用升级后调用 SwanSailorConfig.markHostUpgrade();，以便在启动小程序前，向 Server 请求新的 Sailor

初始化

在 Application 的 onCreate 方法中需要执行 Sailor 初始化逻辑，可参考小程序开源仓库 SwanAppInitHelper#initSwanAppModule()方法中的逻辑

WebViewFactory.initOnAppStart(AppRuntime.getAppContext(), false, false);
if (SwanAppRuntime.getSwanSailorRuntime().isSailorInstalled()) {
    SwanSailorInitHelper.getInstance(appContext).initBWebkitAsync(ProcessUtils.isMainProcess());
    // 主进程中提前唤醒小程序进程，加快小程序启动速度
    if (ProcessUtils.isMainProcess()) {
        SwanAppEnv.get().initIfNecessary(null);
    }
} else {
    SwanSailorCoreInstaller.get().addListener(new OnInstalledListener() {
        @Override
        public void onSuccess() {
            SwanSailorInitHelper.getInstance(appContext).initBWebkitAsync(ProcessUtils.isMainProcess());
            // 主进程中提前唤醒小程序进程，加快小程序启动速度
            if (ProcessUtils.isMainProcess()) {
                SwanAppEnv.get().initIfNecessary(null);
            }
        }
        @Override
        public void onFail() {
            if (DEBUG) {
                Log.e(TAG, "SwanSailorCoreInstaller onFail ");
            }
        }
        @Override
        public void onProgress(long current, long sum) {
            if (DEBUG) {
                Log.i(TAG, "SwanSailorCoreInstaller onProgress: " + current + "/" + sum);
            }
        }
    }).tryInstall();
}

后下载CS协议

请求参数

返回参数

示例：

{
    "errno":0,
    "errmsg":"success",
    "tipmsg":"请求成功",
    "data":{
        "bundle_id":"sailor",
        "version_name":"1.0.0",
        "version_code":100,
        "size":381575,
        "md5":"6aa84bcf7011c228866d309e7f7",
        "download_url":"https://b.bdstic.com/0352eba74839fc661e2ab8fcd.zip"
    }
}

小程序小游戏用到的SO库说明