迁移你的应用至SHOPLINE CLI​

为了提升开发效率和体验，我们推荐使用 SHOPLINE CLI 来开发你的应用。通过 SHOPLINE CLI，你可以快速解决 Partner Portal 的登录问题，同步应用设置，并在本地项目中轻松管理应用配置。
如果你是首次开发 SHOPLINE 应用，请直接按照 SHOPLINE CLI 如何构建应用 指南进行操作，无需阅读以下内容。
对于已上线或正在开发的应用，我们强烈建议你按照本指南将应用迁移至 SHOPLINE CLI，以享受更加便捷的开发流程。

CLI 优点​

使用 SHOPLINE CLI 构建应用包含以下优点：

• 统一的配置文件管理：采用语义简单、直观的 TOML 格式配置文件，方便管理应用配置。
• 标准清晰的应用结构：通过 SHOPLINE CLI 构建标准 应用结构，简化集成开发。
• 本地预览和调试：支持使用指令在本地预览和调试应用程序，实时查看效果并快速定位问题，加速开发迭代。

如何迁移​

标准化目录结构​

- <App Name>
  |-- app				       服务端开发的目录入口
      └──shopline.web.toml	   服务端开发配置文件
  |-- web
      |-- src
          └── index.tsx
      |-- vite.config.ts
      └── shopline.web.toml	   Web前端开发配置文件
  |-- package.json
  |-- shopline.app.toml        应用配置文件

按照如上标准的目录结构来进行应用开发，以维持项目的可拓展性。其中关键目录说明如下：

• app 目录：用于存放服务端代码开发逻辑。
• web 目录：用于存放客户端代码开发逻辑。

如果你的项目中还没有对应的 shopline.app.toml或 shopline.web.toml 文件，你可以按照以下步骤创建它们：

1. 在 <App Name> 目录下创建 shopline.app.toml 文件，用于存放应用相关配置信息。
2. 在 <App Name>/app和 <App Name>/web目录下创建 shopline.web.toml 文件，用于配置应用开发相关启动和构建命令。关于不同 shopline.web.toml文件区别，可以参考 SHOPLINE应用结构文档。

新建配置文件​

配置文件是 SHOPLINE 应用结构中的必要内容，通过使用置文件，你可以指定应用的启动命令、依赖项、环境变量等配置信息。以下将向你详细介绍如何创建必要的 TOML 文件以及配置它，以便让 CLI 能够准确读取配置并启动应用。

应用配置​

app toml是应用的配置文件，首先需要新建一个 shopline.app.toml并将其配置成如下格式，其中权限点是文件的必要内容。

[access_scopes]
scopes = "write_products"

以上权限点取决于应用所需要调用的 Open API，具体的权限点内容可以查看文档权限点列表，同时在应用安装的时候也会提示商家需要授权的权限点内容。

启动配置​

web toml是应用启动所需的配置文件，有关进程启动相关的内容，我们建议配置在对应类型的web.toml文件上面。

在上述提到的标准目录结构中，建议你将 <App Name>/app作为服务端开发的入口，<App Name>/web作为客户端开发的入口文件。因此，对于 web.toml 的配置，也十分简单，只需要在这两个入口文件下各新建一个shopline.web.toml即可。接下来，我们将先讲解客户端的 shopline.web.toml 配置。

Web前端配置​

Web 前端启动配置是由 Node.js 来实现的。无论你选择的构建工具是 Webpack、Vite、Rspack 或是其它，你只需要通过 npm 来运行 run start 或 run dev 命令即可，package.json 文件中配置的脚本决定具体的启动命令。配置内容参考如下。

type="frontend"
[commands]
dev = "npm run dev"
build = "npm run build"

服务端配置​

Server 端的 shopline.web.toml就比较复杂 因为实现服务端的语言是不确定的 这里就需要开发者根据自己开发的语言来决定对应的配置文件的格式。

这里我们会简单示范node和 go两种语言的配置内容：

• node server

type="backend"
[commands]
dev = "npm run dev"
build = "npm run build"

• go server

type="backend"
[commands]
dev = "go run main.go"
build = "go build"

安装依赖​

到了这一步，恭喜你已经完成了配置文件的迁移。下面是关于新建package.json以及依赖安装的内容。

如果你之前是服务端开发人员并且不以node作为开发语言 需要你前往 node官网 安装稳定版本再继续下面的内容

首先你可以在根目录下新建一个package.json，然后配置以下信息：

{
  "name": "shopline-app-template",
  "version": "1.0.0",
  "scripts": {
    "shopline": "shopline",
    "build": "shopline app build",
    "dev": "shopline app dev",
    "dev:reset": "shopline app dev --reset",
  },
  "dependencies": {},
  "author": "SHOPLINE",
  "devDependencies": {
    "@shoplinedev/app": "2.1.0",
    "@shoplinedev/cli": "2.1.0"
  }
}

接下来，在项目的根目录下运行以下命令来安装依赖包。

npm install

除了在根目录下安装依赖外，通常你还需要在 <App Name>/app 和 <App Name>/web 下安装对应语言所需的依赖。

启动应用​

依赖安装完成后， 你可以通过下面的命令来启动你的应用

npm run dev

dev指定启动之后，CLI会生成一个内网穿透的地址 并将其上传到 Partner Portal上面对应应用的 应用地址上。

应用启动成功后，就会出现上面这个预览地址，此时代表你已经成功的完成迁移。