# itriton-warrior

**Repository Path**: ibaleine-open-source/itriton-warrior

## Basic Information

- **Project Name**: itriton-warrior
- **Description**: @itriton/warrior基于uni-app的项目基础架构
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-04-20
- **Last Updated**: 2025-09-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: uni-app

## README

# ITRITON-WARRIOR

## 介绍

[@itriton/warrior](http://itriton.icjs.ink/)，是基于[uni-app](https://uniapp.dcloud.io/)+uview+@itriton/uniapp生态开发的基础模板
## 目录说明
```
-components 组件
-lang 国际化文件
	-locales 国际化文件
-mixins 全局方法
-pages 页面
-static 静态文件
	-styles 公共样式库
	-images 图片资源
-utils 工具
	-api
		-modules 各模块接口
		-request request封装
	-common 原生方法二次封装
	-config 配置文件
	-images.native 本地图片
	-images.online 在线图片
	-location 定位文件
	-router 路由文件
	-update 更新工具
	-util 常用工具方法
-uview-ui 组件库
```


## 项目运行

### 安装依赖
> 目前依赖`uview-ui`、`@itriton/uniapp`、`vue-i18n`，uview使用本地引入，方便灵活修改组件。
* 安装@itriton/uniapp组件库

`npm i @itriton/uniapp@vue2`

* 更新@itriton/uniapp组件库

`npm update @itriton/uniapp@vue2`

* 安装vue-i18n国际化

`npm i vue-i18n`
	
* 更新vue-i18n国际化

`npm update vue-i18n`

## 版本管理

项目使用语义化版本控制 (Semantic Versioning)，版本格式为：`主版本号.次版本号.修订号`

### 版本更新命令

项目提供以下版本更新命令，可自动更新项目中的所有版本号：

- **更新修订号** (例如 1.0.0 → 1.0.1)：
```bash
npm run update-version 或 npm run update-version:patch
```

- **更新次版本号** (例如 1.0.1 → 1.1.0)：
```bash
npm run update-version:minor
```

- **更新主版本号** (例如 1.1.2 → 2.0.0)：
```bash
npm run update-version:major
```

- **指定自定义版本号** ：
```bash
npm run update-version:custom 1.5.0
```

### 更新内容

执行以上命令会同时更新以下文件中的版本号：

- `package.json` 中的 `version` 字段
- `src/utils/config.js` 中的 `version` 变量
- `src/manifest.json` 中的 `versionName`（带点格式，如 "1.2.3"）和 `versionCode`（数字格式，如 "123"）
- `.minicirc` 中的 `version` 字段（用于小程序上传）

### 版本号规则
按照语义化版本控制的规则：

- 主版本号：当进行不兼容的 API 修改时增加
- 次版本号：当增加功能但仍向下兼容时增加
- 修订号：当进行向下兼容的 bug 修复时增加

## API管理

项目提供API自动更新工具，可以根据modules目录中的API模块文件自动生成index.js导出文件。

### API更新命令

- **更新API索引文件**：
```bash
npm run update-api
```

### 功能说明

执行命令后，脚本会：

1. 扫描 `api/modules` 目录下的所有JS文件
2. 自动生成import语句导入所有模块
3. 为每个模块生成命名导出（如: `export const userApi = user;`）
4. 更新 `api/index.js` 文件

### 使用场景

当你在 `api/modules` 目录下添加新的API模块文件后，可以运行此命令自动更新索引文件，避免手动维护导入导出语句。

例如，添加一个新的 `user.js` 模块后，运行 `npm run update-api` 会自动将其添加到 `index.js` 中.

## 国际化语言文件说明

本项目支持以下多语言，所有语言文件位于 `lang/` 目录中，命名规则遵循语言代码标准（如 `en`, `zh-cn`, `pt-br` 等）。

每个文件包含基础翻译字段如下：

```json
{
  "common.ok": "",
  "common.cancel": "",
  "welcome.title": "",
  "welcome.subtitle": ""
}
```

### 📁 支持语言列表

| 语言名称 | 语言代码 | 文件名 |
|-----------|------------|----------|
| 世界语 | `eo` | `eo.json` |
| 丹麦语 | `da` | `da.json` |
| 乌克兰语 | `uk` | `uk.json` |
| 亚美尼亚语 | `hy-am` | `hy-am.json` |
| 俄语 | `ru` | `ru.json` |
| 保加利亚语 | `bg` | `bg.json` |
| 克罗地亚语 | `hr` | `hr.json` |
| 加泰罗尼亚语 | `ca` | `ca.json` |
| 匈牙利语 | `hu` | `hu.json` |
| 南非荷兰语 | `af` | `af.json` |
| 印度尼西亚语 | `id` | `id.json` |
| 吉尔吉斯语 | `ky` | `ky.json` |
| 哈萨克语 | `kk` | `kk.json` |
| 土库曼语 | `tk` | `tk.json` |
| 土耳其语 | `tr` | `tr.json` |
| 塞尔维亚语 | `sr` | `sr.json` |
| 孟加拉语 | `bn` | `bn.json` |
| 巴斯克语 | `eu` | `eu.json` |
| 巴西葡萄牙语 | `pt-br` | `pt-br.json` |
| 希伯来语 | `he` | `he.json` |
| 希腊语 | `el` | `el.json` |
| 库尔德语 | `ku` | `ku.json` |
| 库尔德语 (ckb) | `ckb` | `ckb.json` |
| 德语 | `de` | `de.json` |
| 意大利语 | `it` | `it.json` |
| 拉脱维亚语 | `lv` | `lv.json` |
| 挪威语 | `nb-no` | `nb-no.json` |
| 捷克语 | `cs` | `cs.json` |
| 斯洛伐克语 | `sk` | `sk.json` |
| 斯洛文尼亚语 | `sl` | `sl.json` |
| 日语 | `ja` | `ja.json` |
| 普什图语 | `pa` | `pa.json` |
| 法语 | `fr` | `fr.json` |
| 波兰语 | `pl` | `pl.json` |
| 波斯语 | `fa` | `fa.json` |
| 泰米尔语 | `ta` | `ta.json` |
| 泰语 | `th` | `th.json` |
| 爱沙尼亚语 | `et` | `et.json` |
| 瑞典语 | `sv` | `sv.json` |
| 立陶宛语 | `lt` | `lt.json` |
| 简体中文 | `zh-cn` | `zh-cn.json` |
| 繁体中文 | `zh-tw` | `zh-tw.json` |
| 维吾尔语 | `ug-cn` | `ug-cn.json` |
| 罗马尼亚语 | `ro` | `ro.json` |
| 美国英语 | `en` | `en.json` |
| 芬兰语 | `fi` | `fi.json` |
| 荷兰语 | `nl` | `nl.json` |
| 葡萄牙语 | `pt` | `pt.json` |
| 蒙古语 | `mn` | `mn.json` |
| 西班牙语 | `es` | `es.json` |
| 越南语 | `vi` | `vi.json` |
| 阿塞拜疆语 | `az` | `az.json` |
| 阿拉伯语 | `ar` | `ar.json` |
| 韩语 | `ko` | `ko.json` |
| 马来语 | `ms` | `ms.json` |
| 高棉语 | `km` | `km.json` |

### 语言代码映射表
```
{
  "af-ZA": "af",
  "ar": "ar",
  "az": "az",
  "bg": "bg",
  "bn": "bn",
  "ca": "ca",
  "cs": "cs",
  "da": "da",
  "de": "de",
  "el": "el",
  "en": "en",
  "en-US": "en",
  "en-GB": "en",
  "eo": "eo",
  "es": "es",
  "es-ES": "es",
  "et": "et",
  "eu": "eu",
  "fa": "fa",
  "fi": "fi",
  "fr": "fr",
  "fr-FR": "fr",
  "he": "he",
  "hi": "en",  
  "hr": "hr",
  "hu": "hu",
  "hy-AM": "hy-am",
  "id": "id",
  "it": "it",
  "ja": "ja",
  "kk": "kk",
  "km": "km",
  "ko": "ko",
  "ku": "ku",
  "ckb": "ckb",
  "ky": "ky",
  "lt": "lt",
  "lv": "lv",
  "mn": "mn",
  "ms": "ms",
  "nb": "nb-NO",
  "nl": "nl",
  "nl-BE": "nl",
  "pa": "pa",
  "pl": "pl",
  "pt": "pt",
  "pt-BR": "pt-br",
  "ro": "ro",
  "ru": "ru",
  "sk": "sk",
  "sl": "sl",
  "sr": "sr",
  "sv": "sv",
  "ta": "ta",
  "th": "th",
  "tk": "tk",
  "tr": "tr",
  "ug-CN": "ug-cn",
  "uk": "uk",
  "vi": "vi",
  "zh": "zh-cn",
  "zh-CN": "zh-cn",
  "zh-SG": "zh-cn",
  "zh-TW": "zh-tw",
  "zh-HK": "zh-tw"
}
```
### 使用场景参考（JavaScript 适配示例）：
```
import language from './language.json'

const sysLang = navigator.language || 'en-US'
const langCode = language[sysLang] || 'en'  // fallback to en
```

使用这些语言代码可以在项目中进行国际化配置和切换。