文档中心 > 店铺动态卡片-开发指引

店铺动态卡片-开发指引

插件快捷联调

更新时间：2023/02/07 访问次数：3222

一、简介


在以往插件联调的基础上，新增快捷联调功能，在插件代码频繁变动的情况下，支持插件开发者更加便捷发起插件与主体小程序的联调，从而提升联调效率。


二、使用说明


1）淘宝开发者工具 IDE 1.3.3版本及以上 支持，前往下载。

2）使用场景：模拟器、真机预览、真机调试。

3）使用插件的宿主小程序和插件项目需要使用同一个基础库版本，关于基础库 1.x 和 2.x 的关系，请参见 基础库 2.x 升级。

基础库1.0

基础库 2.0

模拟器 - 静态插件

支持

不支持

真机 - 静态插件

支持

支持

模拟器 - 动态插件

不支持

不支持

真机 - 动态插件

不支持

支持


三、操作引导

1. 添加主体小程序


1）登录【淘宝开放平台】，点击【开发-我的应用】，选择需要添加小程序的插件，点击【应用管理】。


image


2）点击需要进行联调操作的插件，进入插件详情页。


image


3）在插件的详情页，选择【联调管理】，再点击右边的添加联调小程序。


image


4）弹框输入需要进行联调的主体小程序 APPID，点击【确认】按钮，申请建立与主体小程序的联调关系。


image


image


添加后需要主体小程序确认授权才能建立起联调关系，也可点击【撤回】取消添加动作。添加成功后可点击【解绑】按钮解绑与主体小程序的联调关系。


2. 主体小程序确认添加


1）在插件详情页选择【开发设置】，点击左边的【设置】进行操作。

说明：若添加的主体小程序和此插件不是为同一主体账号，则需主体小程序在【端应用】-【开发设置】-【授权插件联调】确认添加或拒绝添加，若为同一主体，则直接添加成功，也可前往【端应用】-【开发设置】-【授权插件联调】查看。


image


2）确认添加成功后，可至【联调管理】页面查看确认是否已添加为联调关系。


image


3. 获取快捷联调插件版本号


IDE 中打开所需快捷联调插件，点击 真机调试，在预览构建完成后，点击版本这一行，将会自动复制版本号至剪贴板，以dev:打头标记快捷联调如 dev:0.2.2102081815.36 。


4. 静态插件联调配置


1）静态插件使用声明


使用插件前，使用者需要在主体小程序 app.json 中声明需要使用的插件。


{
 "plugins": {
    "myPlugin": {
   "version": "*",  
   "provider": "3019235609092837"
    },
    "yourPlugin": {
   "version": "*",
   "provider": "3019235609090000"
    }
 }
}


2）静态插件联调配置


在宿主小程序应用的 mini.project.json 中增加 debugOptions 字段，配置联调信息。

① enable 用于管理当前是否开启插件快捷联调，为 true 时下方配置生效。

② plugins 字段对应 app.json 中的静态插件 APPID。

③ version 字段填入插件的版本标识。


{
 "debugOptions": {
    "enable": true,
    "plugins ": {
   "3019235609092837": { //----------小程序ID
    "version": "dev:0.2.2009071414.41" //----------小程序版本
   },
   "3019235609090000": { 
    "version": "dev:0.2.2009071414.41"
   }
    }
 }
}


5. 动态加载插件联调配置


1）动态加载插件使用声明


使用动态加载插件前，需要在 app.json 中做如下声明。


{ "useDynamicPlugins": true }


在代码中动态加载插件。


my.loadPlugin({
 plugin: '3021001126652765@*',
 success: () => {
    const plugin = requirePlugin('dynamic-plugin://2021001126652765');
 },
});


2）动态加载插件联调配置


在宿主应用的 mini.project.json 中增加 debugOptions 字段，配置联调信息。

① enable用于管理当前是否开启插件快捷联调，为 true 时下方配置生效。

② dynamicPlugins对应动态插件的信息。

③ version 字段填入上一步获得的版本标识。


{
 "debugOptions": {
    "enable": true,
    //动态插件仅会使用dynamicPlugins的值 
    "dynamicPlugins": {
      // 基于appId进行替换
   "3021001126652765": {
    "version": "dev:0.2.2009071414.4"
   }
    }
 }
}


6. IDE 模拟器联调


mini.project.json 配置后请点击 IDE 头部 重启编译 ，此时将依据设定的联调版本进行拉取插件。


7. 真机调试


点击 IDE 右上角 真机预览 或 真机调试 进行真机插件快捷联调。


四、注意事项


1.使用 mini.project.json 配置的方式开启快捷联调，仅在 IDE 模拟器、或真机预览、真机调试等生成的线下版本生效。上传编译时默认忽略该配置。

2.如果强行在 app.json 中配置版本来使用静态插件快捷联调，主体小程序的模拟器、线下预览版本可以拉到联调的插件，请在上传时去掉相关配置。

3.主体小程序线下版本可拉取到插件指定预览版，但主体线上版本无法拉取，且主体不能进入插件内部调试。


FAQ

关于此文档暂时还没有FAQ
有用(0) 我要提问
返回
顶部
阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号