一个帮助 World of Warships 玩家管理战舰和舰长技能装配方案的 App 小程序
打开「战舰工坊」管理自己的方案并分享给需要的战友们把
打开「微信」扫描上方图像中小程序码，或在「微信」中搜索「战舰工坊」
- 命名创建自己的装配方案，从现有版本400多艘战舰和对应指挥官中可视化选择搭配
- 舰长技能模拟器，在装配方案中管理存储舰长技能
- 云端存储和分享，在云端存储管理自己装配方案并快捷分享给微信好友
- 云端近期方案浏览，浏览近期云端用户们所创建的方案
- Feature 首页近期云端方案筛选过滤，防止出现无意义方案等
- Bug Fix 修复 登录页成功后返回编辑页参数失效
- Bug Fix 修复 FittingDetail 方案详情页技能列表仍会显示技能已选的问题
- Bug Fix 修复 舰长技能模拟器 4-05 「进阶射击训练」本地化错误显示为「基础射击训练」相关技能信息
-
Node.js 实际项目开发中使用版本 12.18.1，符合 Taro、React 等要求即可
-
Taro 使用 [email protected] ，需要安装对应 @tarojs/[email protected] 或者使用 npx ，参考 Taro 文档
$ yarn global add @tarojs/[email protected]
$ yarn install# ENV development 运行
$ yarn dev:weapp
# ENV production 运行 用以减少生成 dist 体积真机预览
$ yarn dev:weapp:prod
# build
$ yarn build:weapp打开微信开发者工具，导入编译生成的dist目录
因涉及到微信登录相关，如使用测试 AppID异常请申请一个正常 AppID
项目服务端使用了 LeanCloud 的 ServerLess 解决方案，需要自行申请开发版。
-
打开 应用设置 > 应用 Keys 获取 AppID 和 AppKey
-
将 AppID 和 AppKey 配置在
.travis\leancloudApp.json中，或者直接在src\config\config.ts修改（不建议）。因其涉及到项目安全，故当前项目的leancloudApp.json已经被添加至 .gitignore 忽略，需要手动在``.travis`下创建如下结构：{ "appId": "yourAppID", "appKey": "yourAppKey" } -
配置微信登录相关
- 登录 微信公众平台，在 设置 > 开发设置 中获得小程序 AppID 与 AppSecret
- 前往 LeanCloud 控制台 > 存储 > 用户 > 设置 > 第三方集成，启用「微信小程序」后填写 AppID 与 AppSecret
LeanCloud相关文档
项目使用 Jest / miniprogram-automator 来实现小程序 E2E 测试
测试相关目录
__test__\e2e
- 在微信开发者工具设置， 设置 > 通用设置 > 安全中把服务端口打开
- 注意 win 下大部分人修改了开发者工具路径，需要重新设置 cliPath ，Mac 下大部分为默认
- cliPath 路径设置：
__test__\e2e\helpers\miniProgramCreator.ts - cli Path 问题参考 https://developers.weixin.qq.com/miniprogram/dev/devtools/auto/automator.html 结尾
- cliPath 路径设置：
- 项目需要在开发者工具中已创建，并且开发者账号已经扫码登录，否则运行 E2E 测试后无法调起开发者工具
# 运行 E2E 测试，自动运行 build:weapp 并 jest --runInBand 模式运行
$ yarn e2e根据不同电脑性能调用起微信开发者工具 build 然后加载时间可能过长 jest 报超时
可自行修改每个测试用例文件中 beforeAll 的等待时间，当前为 40000
相关案例和文档
Commit Hook
项目已经使用 husky 配置 pre-commit hook ，会自动运行 Eslint 和 E2E 测试检查，保证提交代码质量。
配置在 package.json中如下：
"husky": {
"hooks": {
"pre-commit": "yarn lint && yarn e2e"
}
}项目使用 Travis CI 和 miniprogram-ci 实现如下流程：
- 远端 master 分支 commit 或 PR 合并时自动发布至微信小程序体验版
- 远端 develop 分支 commit 时自动发布至微信小程序开发版
相关配置：
-
获取上传密钥，打开微信公众平台 > 开发 > 开发设置，下载密钥妥善保管，暂时关闭白名单（如在公司部署使用安全起见设置白名单）
-
使用 Travis CI 的 CLI 工具加密密钥，相关教程可以参考Travis CI 教程 - 5.3 加密文件或官网文档，注意以下要点：
- 登录 Travis CI
$ travis login --com（注意一定要登录到 Travis CI.com，不添加会默认登录 org 将不会自动添加 com 下项目加密环境变量） - 执行完加密命令后到 Travis CI.com 项目中右上角 More options > Settings 检查是否已经有 Environment Variables
encrypted_0xxxxxxx类似的环境变量
- 登录 Travis CI
-
修改
.travis.yml中上传密钥相关环境变量和路径- 将
$encrypted_0fb5a69e10c8_key和$encrypted_0fb5a69e10c8_iv修改为你的环境变量 - 加密生成的
private.key.enc存储在.travis/下，（如文件名不同修改下，-out .travis/private.key请勿修改，后续流程依赖） - 原有的密钥存储可以重命名为
private.key存储在.travis/private.key，因密钥也涉及项目安全已被添加至 .gitignore 忽略，请确保不被提交。放在本地可以使用yarn preview:weapp直接将本地 dist 目录发布至微信小程序开发版
before_install: - openssl aes-256-cbc -K $encrypted_0fb5a69e10c8_key -iv $encrypted_0fb5a69e10c8_iv -in .travis/private.key.enc -out .travis/private.key -d
- 将
-
配置 leancloudApp 相关 AppID 和 AppKey，前面因安全已经忽略了本地
.travis\leancloudApp.json的提交，需要流程中自动再创建一个- 打开 Travis CI 对应的项目，右上角 More options > Settings
- 添加 Environment Variables
leancloud_AppID和leancloud_AppKey，并填写对应的值
至此，Travis CI 相关设置已经OK。
如果你在参考这个文档配置自己的 CI 流程，如不需要在本地运行 miniprogram-ci 则可以将 miniprogramCI\cli.js 所负责的操作移至 .travis.yml before_install 中，然后安装并直接调用 miniprogram-ci
为方便本地项目也可以通过命令行快速发布预览版本，故将 miniprogram-ci 进行了一层封装miniprogramCI\cli.js，自动获取project.config.json中版本号、appID等相关信息，并在package.json中已经预设了一条命令：
{
"scripts": {
"preview:weapp": "node ./miniprogramCI/cli.js preview --robot 3 --desc LocalPreview --keyPath ./.travis/private.key"
}
}如需在本地发布开发版预览直接执行：
$ yarn preview:weapp相关文档文章
All copyright materials provided by Wargaming.net are owned by Wargaming.net.