Launcher Q&A

1. 为什么 UOS Launcher 安装失败了？

检查报错信息，如果出现 「No 'git' executable was found. Please install Git on your system then restart Unity and Unity Hub.」提示，则是当前执行环境未安装 Git，需要安装 Git 后重新启动 Unity 和 Unity Hub，然后重新 launcher 执行安装步骤。 立即安装 Git

2. 安装 Launcher 后自动引入的 UOSLauncherEncrypt 文件夹是什么？是否可以删除？

UOSLauncherEncrypt 文件夹中的脚本主要用于客户端信息加密，不能删除。此外，您可以点击 Unity 编辑器菜单 UOS -> Launcher -> Regenerate Encrypt Key 重新生成加密密钥，以提高安全性。

3. 可以使用 Unity 编辑器的包管理器 (Package Manager) 升级 Launcher 中的 SDK 吗？

不推荐使用 Package Manager 来升级 SDK，因为 SDK 间的依赖关系需要 Launcher 进行管理和控制。请使用 Launcher 中的 SDK 升级按钮来升级 SDK。

4. 打包 WebGL 平台时提示 WebSocket.jslib 冲突？

原因：不同的Package的均引用了 WebSocket.jslib 文件导致打包 WebGL 包体时出现的文件冲突。
解决方案：从提示的路径中删除冲突的文件，保留一份即可。
Package/…/…/WebSocket.jslib would be copied to <PluginPath>/WebSocket.jslib
Package/…/…/WebSocket.jslib would be copied to <PluginPath>/WebSocket.jslib

5. 若想在初始化SDK时使用指定的AppId？

以 CloudSave 为例， 如需与其他 UOS APP 关联，可以使用如下方法：

await CloudSaveSDK.InitializeAsync(string appId, string appSecret)

若初始化 SDK 时传入了 AppId, AppSecret 与其他 UOS APP 关联，则在使用外部 UserID 登录时需要使用对应的 APPID:

await AuthTokenManager.ExternalLoginWithAppId(appId, userId, personaId, personaDisplayName)

6. 使用 Addressables 等资源管理系统时，如何自定义 Launcher 配置资源加载？

UOS Launcher 支持自定义资源加载方式。
使用方式：在访问 Settings 之前，将自定义的资源加载方法赋值给 Settings.LoadMethod。

using Unity.UOS.Common;
using UnityEngine;
using UnityEngine.AddressableAssets;

public class Sample : MonoBehaviour {
    // 示例：用 Addressables 同步加载
    void Start()
    {
        Settings.LoadMethod = () => Addressables.LoadAssetAsync<Settings>("UOSSettings").WaitForCompletion();
        Debug.Log(Settings.AppID);
    }
}

7. 如何卸载已经安装的 UOS SDK ？

在 UOS Launcher 中点击对应 SDK 的版本号，打开 Package Manager。

在 Package Manager 中点击 「Remove」 移除。