46 lines
2.3 KiB
Markdown
46 lines
2.3 KiB
Markdown
# LineUp App
|
||
|
||
这里是 LineUp 多端客户端的工作区。
|
||
|
||
当前 Kotlin Android 客户端是 IM、协议、设备接入与交互闭环的快速实验基线；长期目标是在系统 WebView / WebKit 之上构建 LineUp Mini Runtime，为内置 Renderer 与受限第三方小程序 Surface 提供统一的运行环境。
|
||
|
||
## Git 同步约定
|
||
|
||
客户端工作区使用独立仓库，远端为 `ssh://git@100.121.118.116:2222/lineup/app.git`，`main` 是 Linux 与 macOS 唯一的共享同步分支。每个可验证的客户端改动都应提交并推送到 `origin/main`；不要再通过复制 `node_modules`、`target` 或打包产物在开发机间同步。
|
||
|
||
macOS 首次获取：
|
||
|
||
```bash
|
||
git clone ssh://git@100.121.118.116:2222/lineup/app.git ~/Workspace/lineup-app
|
||
cd ~/Workspace/lineup-app/tauri
|
||
npm ci
|
||
```
|
||
|
||
日常同步（工作区无未提交源码改动时）：
|
||
|
||
```bash
|
||
git pull --ff-only origin main
|
||
```
|
||
|
||
`tauri/node_modules/`、`tauri/dist/` 和 `tauri/src-tauri/target/` 均为本机可再生文件，已被忽略；每台机器按自身架构重新安装和构建。
|
||
|
||
## 文档入口
|
||
|
||
- [DESIGN.md](DESIGN.md)：Android 实验阶段的产品、连接与交互设计；
|
||
- [TECHNOLOGY_SELECTION.md](TECHNOLOGY_SELECTION.md)：已确认的客户端与 Mini Runtime 技术路线；Tauri 2 是第一优先的 Reference Host Spike，Wails v3 在同一基线后续评估；
|
||
- [tauri/README.md](tauri/README.md)：Tauri 2 Reference Host 的实现、构建状态和下一阶段范围；
|
||
- [LineUp App 层架构设计方案](../设计/02.正式方案/lineup-app-layer-architecture.md)：跨端 App Shell、Interaction Kernel、Renderer、Surface 与 Capability 的正式架构；
|
||
- [LineUp UI Surface 与 App Capability 协议](../设计/02.正式方案/lineup-ui-surface-protocol.md)：小程序 Surface 和 Agent 调 App 能力的协议定义。
|
||
|
||
## 当前目录边界
|
||
|
||
```text
|
||
lineup-app/
|
||
├── DESIGN.md # Android 快速实验设计
|
||
├── TECHNOLOGY_SELECTION.md # 已确认的客户端 / Mini Runtime 技术路线
|
||
├── tauri/ # Tauri 2 Reference Host（第一优先 Spike）
|
||
└── README.md # 本目录说明与文档入口
|
||
```
|
||
|
||
实际的唐僧叨叨 Android 上游实验代码保留在 `../upstream/tangsengdaodao-android/`，不与未来的 LineUp 多端客户端工程混放。
|