# 多端应用插件使用指引 为方便开发者实现在多端应用中引入第三方 SDK 或实现原生扩展的一些功能，平台支持开发者通过「多端应用插件」的方式以实现与 Native 的连接与扩展。本文将描述如何创建多端插件 ID、如何基于微信开发者工具创建多端插件工程等操作。 ## 使用说明 - 该功能所依赖的微信开发者工具版本为 ≥ 1.06.2311282（即，开发者需下载最新的 [Nightly 版](/miniprogram/dev/devtools/log.md)开发者工具） - 开发者可在[微信开发者平台-多端应用控制台](https://developers.weixin.qq.com/platform/)或微信开发者工具中创建插件 ID - 当前多端应用需已绑定移动应用，即如果当前多端应用尚未绑定移动应用的不可使用多端插件的功能 ## 其他补充 - 开发的插件仅提供给自己的多端应用使用不需要审核；若开发的插件后续上架插件市场，则需要审核 ## 操作指引 ### 1、创建插件 ID #### 1.1 进入多端应用模式 - 点击「项目 - 新建多端插件」 - 说明：如果没出现「新建多端插件」的选项，开发者需等待几分钟待插件下载完成后，再关掉开发者工具重新打开即可（如果工具版本已经是最新 Nightly，但反复操作多次还是没出现，有可能是插件下载尚未完成，需继续等待一会再重试即可) ![](https://testchu-7gy8occc8dcc14c3-1304825656.tcloudbaseapp.com/img%2Fmelody%2F202310111121004.png) #### 1.2 进入创建多端插件面板 - 在多端插件面板中点击「新建」即可创建插件 ID - 如果已经在多端应用控制台中创建了插件 ID，则可直接下拉选中即可 ![](https://testchu-7gy8occc8dcc14c3-1304825656.tcloudbaseapp.com/img%2Fmelody%2F202310111127965.png) ### 2、创建插件项目 - 如上图，选中插件 ID 后，点击确定即可创建插件项目，并且进入多端插件模式 - 创建的插件项目默认会同时创建 Android 和 iOS 的插件目录，开发者可按需使用 ![](https://testchu-7gy8occc8dcc14c3-1304825656.tcloudbaseapp.com/img%2Fmelody%2F202310271037286.png) ### 3、插件项目介绍与开发 - 插件的目录结构介绍、插件的开发指引、插件的调试操作可查看[iOS 原生插件开发指引](iosPlugin)以及[Android 原生插件开发指引](androidPlugin) ### 4、上传插件代码至平台 - 按照步骤3进行插件的开发调试完成后，即可将插件上传至平台进行发布；发布后即可在多端应用里引用插件进行使用 ![](https://testchu-7gy8occc8dcc14c3-1304825656.tcloudbaseapp.com/img%2Fmelody%2F202310111212862.png) ### 5、发布插件 - 将插件上传至平台后，前往「多端应用控制台 - 插件管理 - 详情 - 版本管理」进行发布插件 ![](https://testchu-7gy8occc8dcc14c3-1304825656.tcloudbaseapp.com/img%2Fmelody%2F202310111214674.png) - 选中版本后点击「设为线上版」即可 ![](https://testchu-7gy8occc8dcc14c3-1304825656.tcloudbaseapp.com/img%2Fmelody%2F202310111215822.png) - 补充：正式版和开发版的区别在于，开发版的版本号是可以被覆盖的，而正式版的版本号是不会被覆盖的，从而保障某个已经发布为正式版的版本，不会因为插件在持续迭代而受影响。 ### 6、多端应用引用插件 - 在多端应用模式下，打开 project.miniapp.json，前往「多端插件配置」并且点击「添加插件」 ![](https://testchu-7gy8occc8dcc14c3-1304825656.tcloudbaseapp.com/img%2Fmelody%2F202310111235738.png) - 然后，启用插件，并且在配置中填写插件 ID 以及对应版本号即可 ![](https://testchu-7gy8occc8dcc14c3-1304825656.tcloudbaseapp.com/img%2Fmelody%2F202310271044907.png) - 补充说明，若你同时为插件的开发者，且开发的是 iOS 插件，可勾选「从本地读取插件」且此时无需填写插件版本 - 配置插件 ID 和版本号之后即可在 JS 中调用插件进行使用，可参考下方示例 ![](https://testchu-7gy8occc8dcc14c3-1304825656.tcloudbaseapp.com/img%2Fmelody%2F202310271047162.png) ### 7、常见问题 #### 7.1 在多端应用中使用目标插件时，是什么时候下载到手机上的？ 答：如果不自行实现动态加载，编包的时候就会把插件 SDK 编进去，即 APP 的安装包中已经打进去了。