自定义loader说明

一、应用自定义loader的作用

开发者可以为自己的应用自定义AppLoader，通过自定义Loader，开发者可以自由选择本APP所需要的原生插件进行loader的编译。同时，自定义loader将与当前APP所有的配置最大限度的保持一致，保持开发调试的APP环境与正式上线的环境一致，保证如微信、微博、百度地图等第三方SDK原生插件，在loader中调试通过后，编译正式版本也不会出现问题。

二、自定义loader执行原理

1、 每个APP项目对应一个自定义loader，开发过程中需要为每个APP项目单独编译自定义loader；如果APP项目对应的自定义loader不存在，则默认使用官方loader

2、 自定义loader完全使用当前APP的所有配置，包括APP名字、ICON图标、启动界面、包名、证书、开放平台SDK原生插件的各种KEY等

3、 自定义loader在运行之初，会根据所选择要“真机同步”APP项目的ID从设备的SD卡（Android平台）或者Document下（iOS平台）的固定目录中找到对应ID的项目的代码，并加载运行

三、自定义loader使用流程

1、 在YonStudio中选中某APP项目，并且在该项目上右键鼠标

2、 在弹出的右键菜单中，选择“编译自定义loader”

3、 之后YonStudio会打开编译界面，选择编译Android 或 iOS 自定义loader。

4、 编译成功后，用手机扫描二维码将自定义loader安装在手机上。

5、 点击YonStudio 中wifi同步快捷键，在弹出窗口点击【通过wifi连接新的设备】，弹出包含ip和端口信息的二维码。 点击 连接

6、 手机上启动自定义loader，点击灰色圆球，输入ip 和端口（也可使用扫一扫），连接开发工具后，可以使用开发工具的wifi同步功能(项目根目录上右键-WIFI同步【全量】)。

7、 自定义loader的更新时机，请参考第五点：何时编译新的自定义loader

五、何时编译新的自定义loader

1、 更换了APP的Android或者iOS证书时，需要重新编译自定义loader，同时如果项目中使用了微信、微博、百度地图等KEY值跟APP证书挂钩的第三方SDK原生插件，需要重新去这些开放平台申请新的KEY

2、 更换了APP的包名时，需要重新编译自定义loader，同时如果项目中使用了微信、微博、百度地图等KEY值跟APP包名挂钩的第三方SDK原生插件，需要重新去这些开放平台申请新的KEY

3、 勾选了新的原生插件或者config文件的feature、meta-data字段有更新时，需要重新编译loader，编译之前，需要将该项目的config文件同步至云端，云端编译自定义loader时将使用最新的config配置

4、 你的APP项目用到的原生插件中，某个或多个原生插件有更新时，需要重新编译自定义loader

5、 官方每周发布新的版本时，如果有涉及到解决了与您项目有关的BUG或者做了新的适配工作时，需要重新编译自定义Loader

六、自定义loader使用注意事项

1、 自定义loader有效期为7天，7天过后需要重新编译

2、 自定义loader不可用于商业用途

3、 切勿随意改动APP项目config文件中的ID值，否则会引起无法编译自定义loader，或者“真机同步时”因ID错误找不到widget而导致加载失败

4、 开发调试过程中，尽量将你的APP项目config中的<preference name="debug" value="true"/>字段置为true，当JS报错时，将会弹出提示到屏幕；发布正式上线版本时可关闭debug

5、 新建完APP项目后，最好登录网站，为该APP项目创建Android或者iOS证书，以保证证书是对应你的项目的。因为如果没有为该APP项目创建证书的情况下，使用的是官方的默认证书，那么自定义loader也将使用该证书，如果项目中用到了微信等与证书相关的原生插件，将带来调试的麻烦

6、 自定义loader只从设备SD卡或者document下加载APP项目，如果该项目被删除或者目录被篡改，将报找不到项目代码的错误

7、 使用iOS自定义loader时，如果已经上传了自己的iOS证书，并且是个人版证书（企业版证书则不受影响），那么，真机同步时，只能在越狱的手机上同步，或者需要在苹果的网站上将非越狱手机加成开发机，否则真机同步时将报类似“打开写文件服务失败”的错误而同步失败

七、自定义Loader对快速生成测试包是否有影响？

自定义Loader与快速生成测试包没有任何关系。 YonStudio“快速生成测试包”时，仍然使用的是官方的loader，而不是自定义loader。因为，快速生成测试包的apk或者ipa安装包，其包名及签名证书等，使用的是YonBuilder移动开发平台的默认配置，将与你的APP配置的不一致，包括原生插件可能也并未包含，可能引起在自定义loader中调试通过的某些功能失效，如微信微博分享，百度地图等。使用时请格外注意！ “快速生成测试包”生成的apk或者ipa包仅仅用于简单的安装包输出，无法用于商业用途！

感谢大家对YonBuilder移动开发平台一直以来的关注和支持，我们会不断地优化产品，为开发者提供更好的服务。

是否仍需要帮助？ 请保持联络！
最后更新于 2024/04/24