docs: 添加中文版README并更新英文版README链接
添加中文版README文档，包含本地预览和开发环境搭建指南 更新英文版README，添加中英文版本切换链接
This commit is contained in:
rionzhao
parent
091d3ae208
commit
3a918509fa
12
README.md
12
README.md
|
|
@ -1,5 +1,7 @@
|
|||
# apps.apple.com Archive
|
||||
|
||||
**[中文版本](./README_CN.md)** | **English Version**
|
||||
|
||||
## Please star this repo!!! 😭😭😭
|
||||
|
||||
## Ads
|
||||
|
|
@ -142,13 +144,3 @@ The source code was obtained from publicly accessible resources through browser
|
|||
|
||||
The content in this repository belongs to Apple Inc. If there are any copyright concerns, please contact for removal.
|
||||
|
||||
---
|
||||
|
||||
*Remember: Always disable sourcemaps in production! 😉*
|
||||
|
||||
## Related
|
||||
|
||||
- [Apple App Store](https://apps.apple.com/)
|
||||
- [Save All Resources Extension](https://chromewebstore.google.com/detail/save-all-resources/abpdnfjocnmdomablahdcfnoggeeiedb)
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -0,0 +1,86 @@
|
|||
# apps.apple.com 归档
|
||||
|
||||
---
|
||||
|
||||
# 安装与运行（本地预览指南）
|
||||
|
||||
这个项目是一份从线上提取的 Svelte/TypeScript 前端归档。仓库同时包含已编译的静态产物（`assets/`、`us/` 等）和源码（`src/`、`shared/`）。下面给出两种常用的本地运行方式：快速静态预览（推荐，零构建）和完整版源码运行（需补齐依赖与私有包）。
|
||||
|
||||
---
|
||||
|
||||
## 方法 A — 快速静态预览（推荐）
|
||||
|
||||
目的：直接预览仓库中已编译的 HTML/CSS/JS（无需安装 Node 或构建）。
|
||||
|
||||
步骤（PowerShell）：
|
||||
|
||||
```powershell
|
||||
# 进入仓库根目录（示例）
|
||||
Set-Location -Path 'd:\dragon\page\apps.apple.com-main'
|
||||
|
||||
# Mac 用户可以直接在根目录里面运行以下代码！！！！！
|
||||
# 启动一个简单的静态 HTTP 服务器（在 8080 端口）
|
||||
python -m http.server 8080
|
||||
|
||||
# 在浏览器中打开（示例页面）
|
||||
# http://localhost:8080/us/iphone/today.html
|
||||
```
|
||||
|
||||
说明：我已在仓库根启动并测试过该静态服务器。如果浏览器仍然报 404，可能是 HTML 引用的资源名与 `assets/` 中实际文件名不一致（例如 HTML 请求 `/assets/index~B87DnNzwx-.js` 但磁盘上是 `indexB87DnNzwx-.js`）。为方便本地预览，我已为部分常见的 tilde (~) 变体创建了文件副本，并在仓库根添加了一个最小 `manifest.json`（供 `/manifest.json` 请求使用）。
|
||||
|
||||
已创建的兼容文件（示例）：
|
||||
|
||||
- `assets/index~B87DnNzwx-.js`（从 `assets/indexB87DnNzwx-.js` 复制）
|
||||
- `assets/index~C-lllyUtRG.css`（从 `assets/indexC-lllyUtRG.css` 复制）
|
||||
- `manifest.json`（仓库根，最小 PWA manifest）
|
||||
|
||||
如果你仍然看到 404，请在终端中查看服务器日志，它会显示缺失的路径。我可以帮你自动为这些引用创建兼容副本，或修改 HTML 指向现有文件名（后者有破坏性）。
|
||||
|
||||
---
|
||||
|
||||
## 方法 B — 从源码运行（开发环境，需构建）
|
||||
|
||||
目的：使用 Svelte/TypeScript 源码进行热重载开发或重新构建产物。注意：仓库引用了私有包（例如 `@amp/*`），可能无法直接从公共 registry 安装。
|
||||
|
||||
主要步骤（概要）：
|
||||
|
||||
1. 安装 Node.js（建议 v18+）并在 PowerShell 中确认 `node` 和 `npm` 可用。
|
||||
2. 在仓库根创建一个 `package.json`（示例见下）。
|
||||
3. 安装必要的依赖（例如 `svelte`, `vite`, `typescript`, `sass` 等）并处理 `@amp/*` 私有包（本地 stub、私有 registry 或替换）。
|
||||
4. 运行 `npm run dev`（或你在 `package.json` 中定义的脚本）。
|
||||
|
||||
示例 `package.json`（供参考 — 需要按项目实际情况调整）:
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "appstore-local",
|
||||
"private": true,
|
||||
"version": "0.0.0",
|
||||
"scripts": {
|
||||
"dev": "vite",
|
||||
"build": "vite build",
|
||||
"preview": "vite preview"
|
||||
},
|
||||
"devDependencies": {
|
||||
"vite": "^5.0.0",
|
||||
"svelte": "^4.0.0",
|
||||
"@sveltejs/vite-plugin-svelte": "^2.0.0",
|
||||
"typescript": "^5.0.0",
|
||||
"sass": "^1.0.0"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
重要提示：
|
||||
|
||||
- 私有包 `@amp/*`：如果代码中大量 `import '@amp/...'`，你需要一个可访问的 registry 或在 `node_modules` 中放置本地实现（stub）。我可以帮你生成最小的本地 stub 包来满足构建，但这可能只够让项目启动而不保证所有功能完好。
|
||||
- 构建时间和依赖大小：安装依赖和首次构建会花时间（取决于网络和硬盘）。
|
||||
|
||||
示例安装与启动（PowerShell）：
|
||||
|
||||
```powershell
|
||||
Set-Location -Path 'd:\dragon\page\apps.apple.com-main'
|
||||
# 如果你已经添加了 package.json
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
Loading…
Reference in New Issue