> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 開始之前

安裝 Node.js、Git 和編輯器，接受您的儲存庫邀請，下載該套件，並檢查您的計算機是否已為第一次移動端執行做好準備。

## 1. 選擇您要執行的內容

使用一臺已聯網的 Windows、macOS 或 Linux 計算機，外加一部手機或已安裝的模擬器來檢視應用。下面的每個安裝步驟都在計算機上執行；手機只負責顯示最終的預覽。

儲存庫是您通過 GitHub 獲得的存放檔案的資料夾。購買 Mobile 會獲得 Mobile 套件儲存庫；All Platforms 套餐提供 monorepo，即包含全部三個應用的資料夾。請接受您所購儲存庫的邀請。Mobile 儲存庫包含 Expo 應用及其共享 UI 包，但不包含 Web 後端——處理賬戶和資料的伺服器——因此應用需要連線一個另行執行的後端。

這些工具準備好一次。下載工具和第一次本機編譯可能需要超過五分鐘的時間。在這些準備工作之後，五分鐘的指南開始；本地執行不會將您的應用程式釋出到網際網路。


## 2.安裝Node.js

開啟下面的Node.js官方下載頁面。選擇編號為 22 或更高的 LTS 版本以及適合您計算機的安裝程式：Windows 上的 .msi 或 macOS 上的 .pkg。開啟下載的安裝程式，保留預設值並完成安裝。 Node.js 讓您的計算機執行應用程式的 JavaScript； npm 隨其安裝。

安裝後關閉並重新開啟終端。在 Windows 上開啟“開始”，鍵入 PowerShell 並將其開啟。在 macOS 上，按 Command + Space，輸入 Terminal，然後按 Enter。在 Linux 上，從應用程式選單中開啟終端。貼上下面的命令，然後按 Enter。 v22.x.x 或 v24.x.x 等結果確認節點可用。如果您看到命令未找到或無法識別，請重新開啟終端或重新安裝節點並啟用其 PATH 選項。

[Node.js 官方安裝程式](https://nodejs.org/en/download)

```
node --version
npm --version
```


## 3.安裝Git和文本編輯器

開啟下面的 Git 下載頁面，選擇您的作業系統並按照其安裝程式進行操作。 Git 下載您的私有儲存庫並記錄檔案更改。在 macOS 上，執行以下命令可能會提供 Apple 的命令列工具安裝；接受它並在完成後重新執行該命令。在 Linux 上，使用 Git 頁面上針對您的發行版顯示的安裝命令。

從其官方下載頁面安裝 Visual Studio Code。這是一個用於開啟專案和儲存配置檔案的文本編輯器。開啟它，選擇“檔案”→“開啟資料夾”（在 macOS 上“檔案”→“開啟”），然後選擇您下載的 supastack 資料夾。您無需編寫程式碼即可完成首次本地演示。

在新開啟的終端中，執行以下命令。結果以 git version 開頭表示 Git 已準備就緒。如果命令丟失，請完成安裝程式並重新開啟終端。

[官方 Git 安裝程式](https://git-scm.com/downloads/)

[Visual Studio Code下載](https://code.visualstudio.com/download)

```
git --version
```


## 4.接受您的GitHub邀請

使用您購買時提供的帳戶在瀏覽器中登入 GitHub。開啟您的 GitHub 邀請電子郵件，選擇檢視邀請並接受訪問。然後開啟邀請的儲存庫。您應該看到它的檔案和一個綠色的程式碼按鈕。 404 通常意味著邀請尚未被接受或者您登入到了不同的 GitHub 帳戶。

選擇程式碼 → 本地 → HTTPS 並複製顯示的地址。在下一步中使用該確切地址。包含尖括號的示例地址是模板：替換它們而不是貼上括號。您不需要猜測組織名稱或將私有儲存庫公開。


## 5. 將專案下載到您的計算機上

為您的專案選擇一個資料夾，例如檔案。在檔案資源管理器或 Finder 中開啟該資料夾。在 Windows 上，右鍵單擊空白區域並選擇在終端中開啟，然後根據需要選擇 PowerShell。在 macOS 上開啟終端，輸入 cd 後跟一個空格，將資料夾拖到終端中，然後按 Enter。終端現在正在該資料夾中工作。

在下面的第一個命令中，將 YOUR_COPIED_HTTPS_ADDRESS 替換為您剛剛複製的 HTTPS 地址。一次執行一行。第一行建立一個名為supastack的新資料夾；第二行進入其中。如果 Git 要求您登入，請完成瀏覽器登入。不要使用您的 GitHub 帳戶密碼作為 Git 密碼。如果瀏覽器登入不可用，請按照下面連結的 GitHub 的 HTTPS 身份驗證指南進行操作。

成功標誌：supastack 資料夾包含 package.json、pnpm-workspace.yaml、apps 和 packages。Mobile 版本的 checkout 在 apps 內只顯示移動應用；All Platforms monorepo 還會顯示 web 和 desktop 應用。這就是儲存庫根目錄。如果 Git 提示目標已存在，請換一個空資料夾或開啟已有的克隆；不要刪除您的工作成果。下一步請保持此終端開啟。

[GitHub HTTPS認證幫助](https://docs.github.com/en/get-started/git-basics/about-remote-repositories)

```
git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack
```


## 6.檢查Corepack和固定的包管理器

執行下面的第一個命令。 Corepack選擇package.json中記錄的pnpm版本； pnpm 下載專案使用的庫。如果 Corepack 請求下載該版本的許可權，請鍵入 y 並按 Enter。本次檢查引腳 pnpm 11.19.0；保留其引腳而不是選擇不同的包管理器。

如果核心包丟失，請執行 npm install --global corepack，重新開啟終端並重試。如果 PowerShell 表示 npm.ps1 或 corepack.ps1 指令碼無法執行，請使用 npm.cmd 或 corepack.cmd 執行該命令，包括 corepack.cmd pnpm install。您不需要更改計算機的執行策略。

過濾後的首次執行命令直接呼叫Corepack。如果您使用 corepack pnpm dev 等 Turbo 命令，Turbo 還需要 PATH 上的 pnpm 命令。下面的 Windows 設定會在使用者可寫的資料夾中建立該命令；其 PATH 更改僅持續當前終端。如果 pnpm 丟失，請在開啟新終端後再次執行此塊。在 macOS/Linux 上，執行 corepack enable；如果報告許可權錯誤，請改用過濾後的首次執行命令。

[瞭解如何執行命令和編輯檔案](https://supastack.dev/zh-tw/docs/mobile/terminal-basics.md)

```
corepack --version
corepack pnpm --version

# Windows PowerShell only, for Turbo commands:
$kitShimDir = Join-Path $env:LOCALAPPDATA 'supastack/corepack-shims'
New-Item -ItemType Directory -Path $kitShimDir -Force | Out-Null
corepack enable --install-directory $kitShimDir
$env:PATH = "$kitShimDir;$env:PATH"
```


## 7. 繼續閱讀 Mobile 指南

當 Node 和 Git 能列印出版本號、Corepack 能選擇鎖定的 pnpm、且您的終端位於包含 package.json 的資料夾中時，您就準備就緒了。從下面選擇一個教程。手機上的 Expo Go 足以完成第一次預覽；原生構建和應用商店賬戶會在後面的指南中介紹。

[讓代理替你跑安裝](https://supastack.dev/zh-tw/docs/mobile/agent-setup.md)

[執行 Mobile 應用](https://supastack.dev/zh-tw/docs/mobile/ship-in-5-minutes.md)

[瞭解 Mobile 技術棧](https://supastack.dev/zh-tw/docs/mobile/tech-stack.md)


## 下一篇

[命令、檔案和配置](https://supastack.dev/zh-tw/docs/mobile/terminal-basics.md)