# rust-vault-app

**Repository Path**: zhulma/rust-vault-app

## Basic Information

- **Project Name**: rust-vault-app
- **Description**: No description available
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-28
- **Last Updated**: 2025-10-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 石棠纪石棠纪

这是一个使用 Ionic + Capacitor + Vue 构建的移动应用。

## 修改应用名称

要修改应用名称，请按以下步骤操作：

1. 修改 `capacitor.config.json` 文件中的 `appName` 字段
2. 修改 `android/app/src/main/res/values/strings.xml` 文件中的应用名称
3. 重新构建项目以应用更改

## 更换应用图标

本项目支持一键更换应用启动图标。默认使用项目根目录下的 `image.png` 文件作为应用图标。

### 自动同步方式（推荐）

只需执行以下步骤：
1. 将新的图标文件命名为 `image.png` 并放置在项目根目录下
2. 运行以下命令生成各尺寸的应用图标：
   ```bash
   npm run generate-assets
   ```

该命令会自动生成适用于不同设备和平台的图标文件，并替换原有图标。

### 手动指定方式

如果要使用其他名称的图片文件作为图标，可以使用：
```bash
npm run generate-assets:icon
```

此命令会使用 `resources/icon.png` 文件生成应用图标。

### 解决图标边距问题

如果生成的图标四周有空白边距，系统会自动修复此问题。如果需要手动修复，请修改以下文件：
- `android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml`
- `android/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml`

移除`<inset>`标签，直接使用`android:drawable`属性。

注意：每次运行图标生成命令后，可能需要重新应用此修复。为了永久解决此问题，建议在每次生成图标后运行以下命令：

```bash
npm run sync
```

这将确保所有更改正确同步到Android项目中。

## 在应用中使用Logo

本项目支持在应用内显示logo。默认使用 `src/assets/images/image.png` 作为应用logo，已在以下页面中集成：

- 登录页面
- 注册页面
- 首页
- Tabs页面

要更换应用内显示的logo，只需替换 `src/assets/images/image.png` 文件即可。

## 构建Android APK

要构建Android APK文件，请按照以下步骤操作：

### 1. 环境检查
首先检查您的环境是否已正确配置：
```bash
npm run build:apk:check
```

### 2. 环境准备
确保已安装以下软件：
- Android Studio
- Android SDK
- Java Development Kit (JDK)

### 3. 安装Android SDK组件并接受许可
首次构建时，您需要通过Android Studio安装必要的SDK组件并接受许可协议：

1. 打开Android Studio
2. 点击"Configure" → "SDK Manager"
3. 在"SDK Platforms"选项卡中，勾选"Android 15 (API Level 35)"
4. 在"SDK Tools"选项卡中，确保以下组件已安装：
   - Android SDK Build-Tools
   - Android Emulator
   - Android SDK Platform-Tools
5. 点击"Apply"并等待安装完成
6. 在安装过程中，系统会提示您接受许可协议，点击"Accept"接受所有协议

### 4. 构建步骤
```
# 构建Web资源
npm run build

# 同步资源到Android项目
npx cap sync

# 构建Debug版本APK
cd android
.\gradlew.bat assembleDebug
```

生成的APK文件位于：
`android/app/build/outputs/apk/debug/app-debug.apk`

### 5. 国内网络优化
项目已配置使用国内镜像加速构建：
- Gradle下载镜像：腾讯云镜像
- Maven仓库镜像：阿里云镜像

## 常识问题解决

### 构建错误：Plugin with id 'com.android.application' not found

如果您在构建 Android 项目时遇到此错误，请确保已完成以下步骤：

1. 安装 Android Studio
2. 在 Android Studio 中安装 Android SDK
3. 确保项目级别的 build.gradle 文件包含 Android Gradle 插件依赖

## 项目结构

- `src/`: Vue 应用源代码
- `android/`: Android 原生项目
- `dist/`: 构建后的 Web 资源

## 开发环境要求

1. Node.js (v16 或更高版本)
2. npm 或 yarn
3. Android Studio (用于构建 Android 应用)

## 安装依赖

```bash
npm install
```

## 开发

```bash
# 启动开发服务器
npm run dev

# 构建 Web 资源
npm run build
```

## Android 构建步骤

1. 确保已安装 Android Studio
2. 在 Android Studio 中打开 `android` 目录
3. 等待 Gradle 同步完成
4. 点击 "Run" 按钮构建并运行应用

或者使用命令行：

```bash
# 同步 Web 资源到 Android 项目
npx cap sync

# 在 Android Studio 中打开项目
npx cap open android

# 构建 APK
npx cap run android
```

## 使用国内镜像

项目已配置使用国内镜像加速依赖下载：
- npm 镜像: https://registry.npmmirror.com
- Gradle 镜像: https://mirrors.cloud.tencent.com/gradle/

如需修改镜像配置，请查看:
- `.npmrc` 文件
- `android/gradle.properties` 文件
- `android/gradle/wrapper/gradle-wrapper.properties` 文件