# capBrowser

**Repository Path**: mistin/capBrowser

## Basic Information

- **Project Name**: capBrowser
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-04
- **Last Updated**: 2025-12-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cap Browser

使用 Capacitor 实现的 Android 浏览器应用，默认加载 https://www.douyin.com

## 项目结构

```
capBrowser/
├── www/              # Web 资源目录（HTML、JS、CSS）
│   ├── index.html
│   └── app.js
├── android/          # Android 原生项目
├── capacitor.config.ts
└── package.json
```

## 安装依赖

```bash
npm install
```

## 添加 Android 平台（已完成）

```bash
npx cap add android
```

## 同步项目到 Android

每次修改 `www` 目录中的文件后，需要同步到 Android 项目：

```bash
npx cap sync
```

## 打开 Android Studio

```bash
npx cap open android
```

## 运行应用

在 Android Studio 中点击运行按钮，或使用命令行：

```bash
npx cap run android
```

## 配置说明

- 默认加载 URL: `https://www.douyin.com`
- 应用 ID: `com.capbrowser.app`
- 应用名称: `Cap Browser`
- Web 目录: `www`

## 开发流程

1. 修改 `www/` 目录中的文件（HTML、JS、CSS）
2. 运行 `npx cap sync` 同步更改到 Android 项目
3. 在 Android Studio 中运行应用

## 何时需要同步

**需要执行 `npx cap sync` 的情况：**
- ✅ 修改 `www/` 目录中的任何文件（HTML、JS、CSS 等）
- ✅ 修改 `capacitor.config.ts` 配置文件
- ✅ 添加或删除 Capacitor 插件
- ✅ 更新 Capacitor 相关依赖

**不需要同步的情况：**
- ❌ 修改 `android/` 目录中的原生代码（Java/Kotlin）
- ❌ 修改根目录的非 Web 资源文件

详细说明请查看 [SYNC_GUIDE.md](./SYNC_GUIDE.md)

## 注意事项

1. 确保已安装 Android Studio 和 Android SDK
2. 确保已配置 Android 开发环境
3. 首次运行需要连接 Android 设备或启动模拟器
4. 修改代码后记得运行 `npx cap sync` 同步更改