移动应用（Android 与 iOS）

Clowld Space 已提供 Android APK，可从下载页获取。具有仓库访问权限的成员，也可以在 Mac 上从源码构建 iOS 版本，安装到 iPhone 或 iPad。

安装后的 App 默认连接 Clowld Space Cloud，使用已有账号即可登录。工作区、任务、评论和执行记录都保存在服务端，不需要从 Web 或 Desktop 手动同步。

安装与更新 Android

1. 在 Android 设备上打开下载页，选择 Android APK。
2. 按 Android 提示允许当前来源安装应用，完成后使用 Clowld Space 账号登录。
3. 生产版会检查更新。确认下载后可以继续使用应用；校验完成后，由 Android 提示确认安装。

更新使用完整安装包。保留相同签名即可覆盖升级，无需先卸载。开发版、staging 和 iOS 构建不使用这套更新机制。

构建 iPhone 或 iPad 应用

准备工作

你需要：

• 一台安装了 Xcode 的 Mac；
• 已在 Xcode → Settings → Accounts 中登录的 Apple ID；
• 一台通过 USB 连接的 iPhone；
• 在 iPhone 的设置 → 隐私与安全性中打开开发者模式；
• Node.js、pnpm 和 Git。

Xcode 或真机开发环境未配置时，先完成 Expo 的 iOS Device 环境配置。

安装到 iPhone

克隆仓库并安装依赖：

git clone https://github.com/sooodasama/clowld-space.git
cd clowld-space
pnpm install

然后从仓库根目录运行：

pnpm ios:mobile:device:prod:release

这会构建一个不依赖 Metro 的 Release 版本，并安装到已连接的 iPhone。第一次构建需要下载 iOS 依赖并编译 React Native，之后会复用 Xcode 缓存。

如果 iPhone 阻止打开应用，到设置 → 通用 → VPN 与设备管理中信任对应的开发者证书。

免费签名的 7 天限制

免费 Apple ID 签名的 App 只能使用 7 天。到期后，把 iPhone 重新连接到 Mac，并再次运行同一条构建命令即可续签。

Apple Developer Program 账号签名的有效期更长，也可以用于 TestFlight 和正式分发。无论使用哪种签名，服务端数据都不会因为重新安装或续签而丢失。

签名失败

如果 Xcode 提示 No matching provisioning profiles found，默认 bundle identifier 可能不属于你的 Apple ID。换成自己控制的反向域名后重新构建：

export EXPO_BUNDLE_IDENTIFIER_PROD=com.yourname.clowld
pnpm ios:mobile:device:prod:release

这个值只需要在你的 Apple Developer team 中可用，不影响 Clowld Space 账号或工作区。

更新

iOS 自助安装版不会自动更新。拉取最新代码、更新依赖并重新构建：

git pull --ff-only
pnpm install
pnpm ios:mobile:device:prod:release

连接自托管实例

Release 构建会把 API 地址写入 App。要连接自托管实例，先修改 apps/mobile/.env.production：

EXPO_PUBLIC_API_URL=https://api.example.com
EXPO_PUBLIC_WEB_URL=https://app.example.com

EXPO_PUBLIC_API_URL 必填；EXPO_PUBLIC_WEB_URL 可选，用于 "Copy link"、"Open on web" 等入口，不设置时这些菜单项不会显示。

修改后重新运行构建命令。iPhone 必须能访问这个 API 地址；使用局域网地址时，不要写 localhost，因为它在 iPhone 上指向手机本身。

开发移动端、使用 Simulator 或连接 staging 的说明见仓库中的 apps/mobile/README.md。

接下来

• 快速上手 — 完成第一次执行。
• Desktop 应用 — 桌面端的标签页与内置守护进程。
• 故障排查 — 连接与执行问题排查。