Belt 项目安装与配置指南

1. 项目基础介绍

Belt 是一个用于启动新的 React Native Expo 应用的命令行界面（CLI）工具。它基于 thoughtbot 团队多年开发经验，整合了多种工具和约定，以帮助开发者快速开始项目。Belt 内置了许多配置，例如 Expo、ESLint、Prettier、TypeScript 等，旨在减少开发者对基础设施的配置工作，从而更加专注于应用程序的核心开发。

该项目主要使用的编程语言是 TypeScript 和 JavaScript。

2. 项目使用的关键技术和框架

• Expo: 一个用于创建 React Native 应用的工具链，可以让你轻松地在 iOS 和 Android 上构建应用。
• ESLint: 一个插件化的JavaScript代码检查工具，用于保持代码风格和错误检查。
• Prettier: 一个代码格式化工具，支持多种语言，用于统一代码风格。
• TypeScript: JavaScript 的一个超集，添加了静态类型选项。
• Jest: 一个广泛使用的 JavaScript 测试框架。
• React Native Testing Library: 用于测试 React Native 应用的工具库。
• MSW (Mock Service Worker): 一个用于模拟 API 请求的服务工作者库。
• React Navigation: 一个用于在 React Native 应用中添加导航的库。
• Tanstack Query: 用于数据 fetching 的库，支持 REST APIs。
• Apollo Client: 用于 GraphQL 数据管理的客户端。

3. 项目安装和配置的准备工作及详细步骤

准备工作

在开始安装 Belt 之前，请确保您的开发环境中已经安装了以下工具：

• Node.js: Belt 需要 Node.js 环境来运行。
• npm 或 Yarn: 用于管理项目依赖。

您可以通过以下命令来检查是否已正确安装这些工具：

node -v
npm -v
# 或者
yarn -v

安装步骤

1. 克隆项目

   使用 Git 将 Belt 项目克隆到本地：

   git clone https://github.com/thoughtbot/belt.git
   cd belt
   

2. 安装依赖

   在项目根目录下，运行以下命令安装项目依赖：

   npm install
   # 或者
   yarn install
   

3. 创建新的 Belt 应用

   使用 Belt CLI 创建一个新的 React Native Expo 应用：

   npx create-belt-app MyApp
   # 或者
   npx create-belt-app MyApp --yarn
   # 或者使用实验性的工具
   npx create-belt-app MyApp --pnpm
   npx create-belt-app MyApp --bun
   

   请将 MyApp 替换为您希望的应用名称。

4. 启动开发服务器

   进入新创建的应用目录，启动开发服务器：

   cd MyApp
   npm run android
   # 或者
   yarn android
   

   这将启动 Expo 开发服务器，并自动在您的默认浏览器中打开一个页面，您可以通过连接的 Android 设备或模拟器来查看应用。

按照以上步骤，您应该能够成功安装并运行 Belt 项目。接下来，您可以按照项目文档中的指南进行进一步的配置和开发。