# note-capacitor

**Repository Path**: ihahaha/note-capacitor

## Basic Information

- **Project Name**: note-capacitor
- **Description**: 一款以语音为核心的使用Capacitor框架编写的手机通讯录与笔记应用，支持录音备注、图片与本地数据库管理，主打离线使用。
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-03
- **Last Updated**: 2026-02-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Note

一款以语音为核心的手机通讯录与笔记应用，支持录音备注、图片与本地数据库管理，主打离线使用。

|                    |                    |                    |
| ------------------ | ------------------ | ------------------ |
| ![1](./docs/1.jpg) | ![2](./docs/2.jpg) | ![3](./docs/3.jpg) |

## 功能特性

- 手机号管理：录音备注、头像、颜色标记、播放、编辑、删除
- 笔记管理：录音 + 图片、拍照上传、图片预览、保存到相册
- 搜索与筛选：关键词搜索、颜色筛选
- 列表分页：每次加载条数可在设置中调整
- 数据迁移：局域网迁移、蓝牙迁移、导入导出
- 扫码：局域网迁移二维码扫描
- 日志与调试：日志查看、调试功能
- 个性化设置：暗黑模式、主题色、字号、分页大小

## 技术栈

- Vue 3 + Vite
- Ionic Vue
- Capacitor 8
- SQLite（@capacitor-community/sqlite）

## 运行环境

- Node.js：`^20.19.0` 或 `>=22.12.0`
- Android 开发（可选）：Android Studio + SDK + JDK

## 快速开始

### 安装依赖

```bash
npm i
```

如果在 Windows 上安装 `@capacitor/assets` 失败，可先设置镜像：

```bash
# cmd
set npm_config_sharp_binary_host=https://npmmirror.com/mirrors/sharp
set npm_config_sharp_libvips_binary_host=https://npmmirror.com/mirrors/sharp-libvips

# PowerShell
$env:npm_config_sharp_binary_host="https://npmmirror.com/mirrors/sharp"
$env:npm_config_sharp_libvips_binary_host="https://npmmirror.com/mirrors/sharp-libvips"

# Git Bash
export npm_config_sharp_binary_host=https://npmmirror.com/mirrors/sharp
export npm_config_sharp_libvips_binary_host=https://npmmirror.com/mirrors/sharp-libvips

npm i -D @capacitor/assets@3.0.5
```

### 本地开发（Web）

```bash
npm run dev
```

### Android 真机/模拟器（开发）

```bash
npm run android:dev
```

## 构建

### Web 构建

```bash
npm run build
```

### Android 构建

```bash
npm run android:build
```

## Android 发布说明

### 修改包名与应用信息

- `capacitor.config.ts` 的 `appId`、`appName`
- Android 包路径：`android/app/src/main/java/<包名>`
- 版本号：`package.json` 的 `version`

### 签名配置（重要）

- 请勿提交 keystore 与签名密码到仓库
- 建议使用本地配置或环境变量传参
- 示例（请替换为你的实际路径和密码）：

```bash
npx cap build android --androidreleasetype APK --signing-type apksigner --keystorepath "<keystorePath>" --keystorepass "<keystorePass>" --keystorealias "<keystoreAlias>" --keystorealiaspass "<keystoreAliasPass>"
```

### 生成签名文件（示例）

```bash
keytool -genkeypair -v -keystore app-release.keystore -alias app -keyalg RSA -keysize 2048 -validity 10000
```

## 图标生成

替换 APP 图标后执行：

```bash
npx @capacitor/assets generate --android
```

## 调试

远程调试：

```text
chrome://inspect/#devices
edge://inspect/#devices
```

注意：若点击 inspect 后空白，请确保浏览器可访问 Google DevTools 资源，或改用 Edge。

## 资源来源

- 图标：https://icon-icons.com/zh/icon/book/75464