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