从 Shopify 脚本迁移到 Shopify Functions
Shopify Functions与 Shopify 脚本类似,两者都允许开发人员创建自定义商务体验。
Shopify Functions
Shopify Functions 随应用一起安装。系统直接在 Shopify 后台中将 Shopify Functions 与其他功能一起配置,这意味着商家在创建或修改自定义项时不需要使用代码。与运行 Shopify 脚本相比,运行 Shopify Functions 的 WebAssembly 平台的性能更高,可在 5 毫秒以内执行代码。因此,Shopify Functions 可以支持大型促销活动,例如限时抢购,同时性能不会降低。
通过使用 Shopify Functions,开发人员可以在其自己的本地环境中进行编码和单元测试。开发人员在应用中分发 Shopify Functions 自定义项,而不是将 Ruby 代码复制并粘贴到每个商店中。最后,使用 Shopify Functions 可减少超时和 CPU 内存限制问题。
迁移到 Shopify Functions,并附带 Shopify 脚本自定义报告
Shopify 脚本自定义报告是 Shopify 后台的个性化页面,显示商店中正在运行的脚本自定义项,并提供可以帮助您重新创建自定义项的 Shopify Functions 文档或相关应用链接。
Shopify 脚本自定义报告是自动生成的。您还能以 CSV 文件的形式导出报告并查看。您需要在 2025 年 8 月 28 日之前使用 Shopify Functions 重新创建您的自定义项。
检查您的自定义项
根据您使用的脚本,您的报告页面可能包含支付网关、发货和产品折扣等自定义项。
每个部分都可以包含 Shopify 脚本自定义项的名称、说明和源文件链接和使用 Shopify Functions 构建且特定于您的自定义项的推荐应用的链接,以及 Shopify Functions 教程的链接。
查看报告的信息以决定是否要使用以下选项重新创建自定义项:
- 使用 Shopify Functions 构建您自己的解决方案
- 安装通过 Shopify Functions 构建的应用
重新创建您的自定义项
在 Shopify 后台中,转到设置 > 应用和销售渠道。
点击 Script Editor 。
在替换 Shopify 脚本的横幅中,点击替换 Shopify 脚本。
在您的自定义报告的每个部分中,执行以下任一操作:
- 若要查看您现有的 Shopify 脚本自定义项,请点击自动检测到的自定义数量下的脚本名称。
- 若要查看或安装与您的脚本匹配且兼容的应用,请在推荐的应用部分点击安装您希望使用的应用 ,或点击更多类似应用,以查找其他兼容的应用。
- 若要查看 Shopify Functions 教程,请在如何使用 Shopify Functions 重新创建部分点击相关功能的 API 链接。
当您成功完成了对应用或 Shopify Functions 自定义项的测试后,您可以停用要替换的脚本。
配合使用 Shopify 脚本和 Shopify Functions
使用 checkout.liquid
进行自定义的结账页面的 Shopify 脚本以及在 2025 年 8 月 28 日前升级的结账页面的 Shopify 脚本将继续工作。
可以在一个商店中同时使用 Shopify 脚本和 Shopify Functions。如果您的脚本当前无法替换为 Shopify Functions,请继续使用 Shopify 脚本,直到 Shopify Functions API 满足您的需求为止。请参阅以下内容,了解 Shopify 脚本和 Shopify Functions 之间的交互方式。
订单项目脚本
订单项目脚本在 Shopify Functions 之前执行,包括应用创建的折扣。订单项目脚本无法访问通过函数和应用进行打折的金额。
脚本只能访问应用于结账流程的第一个折扣码,无法访问可能已经使用的其他折扣码。例如,使用 reject
仅会对结账流程中应用的第一个折扣执行操作,而不会影响其他折扣。
发货脚本
发货脚本在 Shopify Functions 创建的发货自定义项之后执行。脚本不能对修改后的配送自定义项重命名结果执行操作,但可以对移动或隐藏的自定义项执行操作。
付款脚本
付款脚本在 Shopify Functions 创建的付款自定义项之后执行。脚本不能对修改后的付款自定义项重命名结果执行操作,但可以对移动或隐藏的自定义项执行操作。