docs(README): 更新README文件内容并添加本地预览指南
This commit is contained in:
rionzhao
parent
7adfd412b1
commit
091d3ae208
95
README.md
95
README.md
|
|
@ -1,11 +1,98 @@
|
||||||
## please star this repo :-)
|
# apps.apple.com Archive
|
||||||
|
|
||||||
ad
|
## Please star this repo!!! 😭😭😭
|
||||||
|
|
||||||
# [genshin-ugc.com](https://genshin-ugc.com) is for sale.
|
## Ads
|
||||||
# [miliastra-wonderland.com](https://www.miliastra-wonderland.com/) is for sale!!!
|
## [genshin-ugc.com](https://genshin-ugc.com) is for sale.
|
||||||
|
## [miliastra-wonderland.com](https://www.miliastra-wonderland.com/) is for sale!!!
|
||||||
email me hilda_quan@163.com
|
email me hilda_quan@163.com
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
# Installation and Running (Local Preview Guide)
|
||||||
|
|
||||||
|
This project is an extracted Svelte/TypeScript frontend archive from online. The repository contains both compiled static assets (`assets/`, `us/`, etc.) and source code (`src/`, `shared/`). Here are two common ways to run it locally: Quick Static Preview (recommended, zero build) and Full Source Code Development (requires dependencies and private packages).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Method A — Quick Static Preview (Recommended)
|
||||||
|
|
||||||
|
Purpose: Directly preview the compiled HTML/CSS/JS from the repository (no Node.js installation or build required).
|
||||||
|
|
||||||
|
Steps (PowerShell):
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# Navigate to repository root (example)
|
||||||
|
Set-Location -Path 'd:\dragon\page\apps.apple.com-main'
|
||||||
|
|
||||||
|
# Start a simple static HTTP server (on port 8080)
|
||||||
|
python -m http.server 8080
|
||||||
|
|
||||||
|
# Open in browser (example page)
|
||||||
|
# http://localhost:8080/us/iphone/today.html
|
||||||
|
```
|
||||||
|
|
||||||
|
Notes: I have tested this static server at the repository root. If you still get 404 errors in the browser, it might be because the HTML references resource names that don't match the actual filenames in `assets/` (e.g., HTML requests `/assets/index~B87DnNzwx-.js` but the file on disk is `indexB87DnNzwx-.js`). For convenient local preview, I've created compatibility copies for some common tilde (~) variants and added a minimal `manifest.json` at the repository root (for `/manifest.json` requests).
|
||||||
|
|
||||||
|
Created compatibility files (examples):
|
||||||
|
|
||||||
|
- `assets/index~B87DnNzwx-.js` (copied from `assets/indexB87DnNzwx-.js`)
|
||||||
|
- `assets/index~C-lllyUtRG.css` (copied from `assets/indexC-lllyUtRG.css`)
|
||||||
|
- `manifest.json` (repository root, minimal PWA manifest)
|
||||||
|
|
||||||
|
If you still see 404 errors, check the server logs in the terminal - they will show the missing paths. I can help you automatically create compatibility copies for these references, or modify the HTML to point to existing filenames (the latter is destructive).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Method B — Running from Source (Development Environment, Requires Build)
|
||||||
|
|
||||||
|
Purpose: Use the Svelte/TypeScript source code for hot-reload development or rebuilding the assets. Note: The repository references private packages (e.g., `@amp/*`) that may not be installable from public registries.
|
||||||
|
|
||||||
|
Main steps (overview):
|
||||||
|
|
||||||
|
1. Install Node.js (recommended v18+) and confirm `node` and `npm` are available in PowerShell.
|
||||||
|
2. Create a `package.json` at the repository root (example below).
|
||||||
|
3. Install necessary dependencies (e.g., `svelte`, `vite`, `typescript`, `sass`, etc.) and handle `@amp/*` private packages (local stubs, private registry, or replacements).
|
||||||
|
4. Run `npm run dev` (or the script you defined in `package.json`).
|
||||||
|
|
||||||
|
Example `package.json` (for reference - needs adjustment based on actual project requirements):
|
||||||
|
|
||||||
|
```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"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Important notes:
|
||||||
|
|
||||||
|
- Private packages `@amp/*`: If the code extensively uses `import '@amp/...'`, you'll need an accessible registry or place local implementations (stubs) in `node_modules`. I can help you generate minimal local stub packages to satisfy the build, but this might only be enough to start the project without guaranteeing all functionality works.
|
||||||
|
- Build time and dependency size: Installing dependencies and the first build will take time (depending on network and disk).
|
||||||
|
|
||||||
|
Example installation and startup (PowerShell):
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
Set-Location -Path 'd:\dragon\page\apps.apple.com-main'
|
||||||
|
# If you've already added package.json
|
||||||
|
npm install
|
||||||
|
npm run dev
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
# Apple App Store frontend source code archive
|
# Apple App Store frontend source code archive
|
||||||
|
|
||||||
Extracted from [https://apps.apple.com/](https://apps.apple.com/). Saved using the Chrome extension [Save All Resources](https://chromewebstore.google.com/detail/save-all-resources/abpdnfjocnmdomablahdcfnoggeeiedb).
|
Extracted from [https://apps.apple.com/](https://apps.apple.com/). Saved using the Chrome extension [Save All Resources](https://chromewebstore.google.com/detail/save-all-resources/abpdnfjocnmdomablahdcfnoggeeiedb).
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue