# 职来 · App Store / Google Play 截图流水线

本目录为「职来」App 的商店素材（App Store Connect + Google Play Console）准备区，遵循
[Expo App Store Screenshots](https://www.npmjs.com/package/expo-app-store-screenshots) 技能的目录与命名约定。

## 目录结构（约定）

```
screenshots/<locale>/<device>/NN-<device>-<screen>.png
```

- `<locale>`：BCP-47 标签，当前为 `zh-CN`（App Store Connect 上传时需映射为 `zh-Hans`）。
- `<device>`：`iphone` / `ipad` / `android-phone`。
- `NN`：两位序号，保证排序一致（见 `capture-manifest.json`）。
- `<screen>`：页面 kebab slug。

当前已预建：`screenshots/zh-CN/{iphone,ipad,android-phone}/`（含 `.gitkeep` 占位）。

## 商店目标尺寸

| 设备           | 尺寸        | 说明                                   |
| -------------- | ----------- | -------------------------------------- |
| `iphone`       | 1284×2778   | App Store 6.5" 展示（捕获后缩放）      |
| `ipad`         | 2064×2752   | App Store 13" 展示（原生尺寸）         |
| `android-phone`| 1440×3120   | Google Play 手机（9:19.5）             |

## 待捕获画面

见 `capture-manifest.json`。已包含本次新增的 4 个页面：
`skill-cloud`、`salary-calculator`、`progress`、`identity-select`，以及核心营销页
（首页 / 岗位详情 / 岗位对比 / 竞争力排名 / 我的 / 选择身份）。

## ⚠️ 本机环境限制（Windows 家庭版）

该技能的捕获流程依赖 **macOS（Xcode CLI `xcrun simctl`）、`adb`、ImageMagick 7+（`magick`）**，
当前 Windows 家庭版环境 **均不可用**，因此无法在本机直接产出真实 PNG 截图。

### 在 Windows 上可做的替代（预览 / 占位）

- 打开 `preview.html`（本目录）在浏览器中查看 iPhone 设备框内的各屏视觉稿；
  可用浏览器「截图」或打印为 PDF/PNG 作为商店素材的**版式占位**，但最终上架素材仍需真实设备截图。
- 全部页面已在 `app/` 中按 Expo Router 实现，真实捕获时直接以 deep link 打开即可。

### 真实截图应在 macOS / 真机完成

1. 安装并信任 Expo App Store Screenshots 技能，获得 `assets/` 下的捕获脚本。
2. 预构建并安装 release 包到 iOS 模拟器 / Android 模拟器或真机（确认 UI 与源码一致）。
3. 依据 `capture-manifest.json` 的 `path` 作为 deep link 路径（`mydreamjob:///<path>`）：
   ```bash
   # 示例：iPhone 捕获（需在 macOS 执行，本机无法运行）
   bash assets/ios-capture.sh "$IPHONE_UDID" "mydreamjob:///tools/skill-cloud" \
        "screenshots/zh-CN/iphone/05-iphone-skill-cloud.png"
   ```
4. 缩放至目标尺寸并写入 `summary.md`：
   ```bash
   bash assets/resize.sh "screenshots/zh-CN/iphone" 1284x2778
   bash assets/resize.sh "screenshots/zh-CN/android-phone" 1440x3120
   ```
5. 上传（需对应商店 API 凭据）：
   - App Store Connect：`zh-CN` → `zh-Hans`，`--device iphone|ipad`
   - Google Play：`--image-type phoneScreenshots --dir screenshots/zh-CN/android-phone`

> 提示：技能脚本中 `deep link` 形式为 `<scheme>:///<path>`（三段斜杠，host 为空），
> 与 Expo Router 一致。捕获前务必先 `assets/detect-app-config.sh` 确认 `APP_SCHEME` / `IOS_BUNDLE_ID` / `ANDROID_PACKAGE`。