WeTrident项目开发指南：从环境搭建到本地测试

项目概述

WeTrident是一个功能强大的移动应用开发框架，提供了状态管理、页面导航、网络请求等核心功能模块。本文将为开发者详细介绍如何搭建WeTrident的开发环境、理解项目结构、进行本地开发和测试验证。

环境准备

基础工具安装

WeTrident开发需要以下工具支持：

1. wml：用于开发过程中的文件同步，实时同步library目录的修改到测试项目
2. verdaccio：用于发布前本地模拟npm发布环境
3. nvm：用于Node版本管理，确保团队使用统一的Node环境

Node环境配置

使用nvm安装项目指定的Node版本：

nvm install

项目结构解析

WeTrident采用模块化设计，主要目录结构如下：

.
├── __tests__         # 测试用例目录
├── app-seed          # 项目模板，包含多种初始化模板
├── docs              # 项目文档
├── library           # 核心功能模块
├── libraryDev        # 开发测试工程，兼具Demo功能
├── local-cli         # 项目级CLI工具
├── traversal-server  # 页面自动化遍历服务
├── trident-cli       # 全局CLI工具
├── trident-ui        # 配套UI组件库
└── website           # 项目官网

核心模块说明

1. library：包含状态管理、导航、网络等核心功能
2. libraryDev：开发测试工程，用于验证library的修改
3. trident-cli：提供项目初始化和环境检查功能

开发流程

1. 启动测试工程

首先安装全局CLI工具：

npm i -g @webank/trident-cli

进入libraryDev目录并启动：

cd libraryDev
tdt install       # 安装依赖
tdt run ios       # 启动iOS模拟器
tdt run android   # 启动Android模拟器

2. 连接本地库文件

默认情况下，libraryDev引用的是已发布的trident版本。要连接本地开发版本：

npm run syncLib

此命令会将library和trident-ui目录同步到libraryDev的node_modules中，并保持实时同步。

3. 添加新依赖

当需要新增依赖时：

1. 在libraryDev/package.json中添加依赖
2. 在根目录package.json中也需添加相同依赖

本地测试发布

使用Verdaccio模拟发布

1. 启动Verdaccio服务：

verdaccio

2. 配置npm使用本地registry：

npm set registry http://localhost:4873/

3. 执行发布命令：

npm run publishAll

此命令会发布@webank/trident-cli和@webank/trident两个包到本地registry。

开发建议

1. 保持环境统一：严格使用项目指定的Node版本和工具链
2. 充分测试：修改library后，应在libraryDev中充分验证
3. 文档同步：代码修改后及时更新相关文档
4. 模块化开发：新功能尽量以模块形式添加，保持代码结构清晰

通过以上流程，开发者可以高效地进行WeTrident的功能开发和验证工作。