Skip to content

app dev 命令

app dev 命令用于启动本地开发环境,支持实时预览和测试应用功能。它会自动处理应用构建、环境配置和开发商店关联等任务。

命令格式

bash
genstore app dev [options]

使用场景

  • 本地功能开发:开发者可在本地环境中实时预览应用变更,快速验证功能实现效果,提升开发效率。
  • 扩展功能调试:开发团队可在开发商店中测试扩展功能,确保功能正确性和兼容性。
  • 配置效果验证:运营人员可在正式发布前预览配置变更效果,降低发布风险。

TIP

  • 使用开发商店需要商店所有者权限或员工账户权限。
  • 首次使用时会自动创建必要的员工账户。
  • 配置信息会被保存,再次运行时可跳过配置步骤。
  • 可使用 --reset 配置项重新配置。

使用步骤

完成应用的初始化后,运行 app dev 命令,CLI 将引导您完成以下配置步骤:

应用关联

  • 选择关联已有应用(--client-id)或创建新应用。
  • 将项目与您的合作伙伴账户或组织关联。

开发商店配置

  • 选择用于测试的开发商店(如只有一个开发商店,系统将自动选择)。
  • 使用提供的链接在商店中安装应用。

环境设置

  • 配置开发隧道(可选择使用 --tunnel-url 自定义隧道)。
  • 在合作伙伴控制面板更新应用 URL。
  • 如希望手动配置预览 URL,可选择 " 不,从不 "。

功能启用

  • 启用开发商店中的扩展预览。
  • 配置应用凭据和访问范围。
  • 为 Admin API 提供服务支持。

服务启动

  • 构建应用和扩展。
  • 启动本地服务。
  • 提供预览访问 URL。

配置项

app dev 命令提供了以下配置项,以满足不同的需求:

bash
--client-id <>
  • 环境变量:GENSTORE_FLAG_CLIENT_ID
  • 指定要使用的应用客户端 ID。
  • 用于跳过应用选择步骤。
bash
--reset
  • 环境变量:GENSTORE_FLAG_RESET
  • 清除已保存的配置信息。
  • 重新执行所有配置步骤。
bash
--tunnel-url <>
  • 环境变量:GENSTORE_FLAG_TUNNEL_URL
  • 指定自定义的开发隧道 URL。
  • 格式:"https://my-tunnel-url:port"
bash
-c, --config <>
  • 环境变量:GENSTORE_FLAG_APP_CONFIG
  • 指定要使用的应用配置名称。
  • 用于管理多环境配置。

示例

使用配置项指定店铺 ID

bash
genstore app dev --client-id your-client-id

使用环境变量指定店铺 ID

bash
export GENSTORE_FLAG_CLIENT_ID=your-client-id
genstore app dev