自定义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移动开发平台一直以来的关注和支持,我们会不断地优化产品,为开发者提供更好的服务。

是否仍需要帮助? 请保持联络!
最后更新于 2023/01/18