创建NEAR应用教程：深入理解near/create-near-app

创建NEAR应用教程：深入理解near/create-near-app

create-near-app Create a starter app hooked up to the NEAR blockchain 项目地址: https://gitcode.com/gh_mirrors/cr/create-near-app

1. 目录结构及介绍

创建一个基于near/create-near-app的项目后，你会看到以下典型的目录结构：

myNearProject/
├── contract      # 合同代码存放目录（根据选择的语言，可能是js或rs子目录）
│   └── ...         # 包含你的智能合约源码
├── frontend      # 前端应用程序目录
│   ├── public     # 不经过Webpack处理，直接复制到输出目录的静态资源
│   ├── src        # 主要的前端应用源代码
│   │   ├── pages   # 页面组件
│   │   ├── components # 共享组件
│   ├── package.json # 前端依赖和脚本
│   └── ...         # 根据所选框架（如Next.js）可能有其他标准文件
├── scripts       # 自定义构建或部署脚本（可选）
├── package.json  # 主项目的包管理文件，包含了创建项目时和项目相关的脚本
├── README.md     # 项目介绍和快速上手指南
└── ...

这个结构清晰地区分了前端应用与智能合约开发的部分，使得开发者能够高效地进行工作。

2. 项目的启动文件介绍

在near/create-near-app中，主要的启动逻辑通常位于每个前端应用模板的package.json内的脚本命令。例如，如果你使用的是基于Next.js的模板，关键的启动文件就是通过pnpm run dev调用的。这通常是指向内部脚本或者直接执行Next.js的开发服务器命令。对于智能合约部分，运行测试或编译合约通常通过直接在合同目录下执行相应的命令来完成，如使用near-dev-js或Rust的cargo。

// 示例中的package.json片段
{
  "scripts": {
    "dev": "node index.js", // 这是在项目根目录下的简单示例，实际命令依具体模板而定
    "start": "npm run build && node dist/index.js", // 生产环境启动命令
    ...
  }
}

请注意，具体的启动命令可能会根据你选择的应用类型（如Next.js的app或pages路由器）和语言（JavaScript或Rust）有所不同。

3. 项目的配置文件介绍

前端配置 - package.json

package.json不仅列出了项目依赖，还包含了一系列执行不同任务的脚本，比如开发模式下的启动(dev)，构建(build)，以及测试等。这是控制前端应用行为的核心文件。

智能合约配置 - Cargo.toml 或 package.json

对于Rust编写的智能合约，其配置文件是Cargo.toml，其中包含了依赖项、版本信息以及编译指令。而JavaScript合约则依赖于其所在目录下的package.json进行管理和构建配置。

.env 文件（可选）

虽然不是所有项目都包含，但.env文件用于存储环境变量，如NEAR网络的访问密钥，这对于连接至NEAR区块链非常必要。这不属于near/create-near-app直接提供的配置，但它是与项目集成的重要一环。

以上是对near/create-near-app基础结构及其重要组成部分的简要介绍。了解这些结构和文件的作用对开发NEAR平台上的去中心化应用至关重要。

create-near-app Create a starter app hooked up to the NEAR blockchain 项目地址: https://gitcode.com/gh_mirrors/cr/create-near-app