# 克隆仓库，这将创建一个名为 my-turbine-mp 的新目录
# 将 'git@github.com:turbine-boilerplates/<boilerplate-name>.git' 替换为从 GitHub 仓库复制的链接
# 您可以将 my-turbine-mp 替换为任何您想要的项目名称
git clone git@github.com:turbine-boilerplates/<boilerplate-name>.git my-turbine-mp

# 导航到目录
cd my-turbine-mp

安装依赖

在终端中运行以下命令来安装依赖。（您可以选择使用 yarn、npm 或 pnpm 安装依赖，这只是个人偏好问题。）

yarn install

配置项目

1. 打开您的代码编辑器

打开您喜欢的代码编辑器。

# 打开您的代码编辑器（Cursor、VSCode、Sublime Text 等）
cursor .

有许多代码编辑器可供选择，例如 Cursor、VSCode、Sublime Text 等。我们推荐使用 Cursor，因为它是一款非常强大的 AI 辅助代码编辑器，可以帮助您更快更高效地编写代码。

Load the code

2. 设置 `.env` 文件

.env 文件用于存储项目的环境变量。这些文件通常不会包含在仓库中，因为它们包含敏感信息，例如 API 密钥和密钥。

在 Turbine 项目中，您可以在根目录下找到 .env.example 文件。这个文件给出了您需要存储的信息示例，以便正确运行项目。

# .env.example
TARO_APP_ID=fill_in_with_your_app_id
TARO_APP_BAAS_ID=fill_in_with_your_baas_id

将 .env.example 文件的内容复制并粘贴到您的 .env.development 和 .env.production 文件中。

# 在您的终端中，运行以下命令来复制 .env.example 文件的内容
cp .env.example .env.development
cp .env.example .env.production

TARO_APP_ID 是您的微信小程序 ID。

如果您还没有一个，您可以按照这里的步骤创建一个。

如果您已经注册了一个账户，您可以登录到微信小程序控制台并找到您的 APP ID 在 设置 > 基本设置 > 账号信息 部分。更多详情请参阅这里。

TARO_APP_BAAS_ID 是您的 Baas ID。BaaS（后端即服务）是一个为您的微信小程序提供后端基础设施和数据库的服务。更多详情请参阅这里。

如果您还没有一个，您可以按照这里的步骤创建一个。

3. 编译项目

Taro JS 将编译您的 React JS 代码，并输出一个微信小程序项目，因此您可以在微信开发者工具中运行项目，并在将来发布到腾讯。

有两种编译项目的方式：

1. 在开发模式下运行

这意味着每次您对代码进行更改，项目都会被编译，并且更改会反映在微信开发者工具中。

  # 在您的终端中，运行以下命令来编译项目
  yarn dev:weapp

2. 在生产模式下运行

这意味着项目只会被编译一次，并且每次您对代码进行更改，您需要再次运行命令来编译项目。这对于您想要发布项目到腾讯非常有用，因为它以更高效的方式编译项目。

# 在您的终端中，运行以下命令来编译项目
yarn build:weapp

在微信开发者工具中运行项目

1. 下载微信开发者工具

Turbine 代码模板是针对微信小程序的，因此您需要打开微信开发者工具来运行项目。您可以下载最新稳定版本的微信开发者工具这里。

2. 打开微信开发者工具

通过前往 项目 > 导入项目 在顶部菜单栏中导入项目。这个窗口会提示您选择项目的路径。

导入项目

选择项目的路径，选择 使用云开发 并点击 创建 以在微信开发者工具中打开项目。

在微信开发者工具中打开项目

Voila! 您现在应该在微信开发者工具中看到项目。

Open the project in Wechat Developer Tools

快速开始

前置要求

获取代码模板

1. 选择您的 Turbine 代码模板

2. 克隆代码仓库