下載及建置應用程式#

MeDo 的專案程式碼匯出功能可讓你下載應用程式程式碼，每次下載需消耗 80 點數。

場景及使用案例：

1. 對於簡單的前端應用程式，開發者下載 zip 檔案後，可直接在本機部署並運行下載的程式碼包。
2. 對於涉及後端資料儲存的複雜應用程式，開發者需要進行一些額外開發，以整合 Supabase 服務。

#如何下載應用程式程式碼？

應用程式成功生成後，編輯介面上方會出現「下載」按鈕。只需點擊此按鈕，即可下載應用程式的程式碼包。請注意，應用程式生成過程中無法下載程式碼。

下載的程式碼版本會對應開發者目前正在編輯的特定應用程式版本。

需要注意的是，如果在開發過程中使用編輯器進行了任何 GUI 修改（例如編輯字體、顏色等），下載程式碼前必須先預覽或發佈應用程式。這可確保下載的程式碼包包含所有 GUI 修改。否則，直接下載的程式碼將不包含這些 GUI 變更。

#開發指南

下載程式碼包後，你需要先按照以下說明設定環境（安裝 Node.js 及 npm），然後使用 IDE 開啟程式碼包，在本機部署並運行應用程式。

IDE： 你可以選擇 VSCode、IntelliJ IDEA，或使用自己偏好的 IDE 進行本機程式碼編輯。

#環境要求

# Node.js ≥ 20
# npm ≥ 10
示例：
# node -v   # v20.18.3
# npm -v    # 10.8.2

#在 Windows 上安裝 Node.js

# 步驟 1：瀏覽 Node.js 官方網站：https://nodejs.org/，點擊下載。網站會自動建議適合你系統的版本（32 位元或 64 位元）。
# 步驟 2：運行安裝程式：雙擊已下載的安裝程式以運行。
# 步驟 3：完成安裝：按照安裝精靈完成流程。
# 步驟 4：驗證安裝：開啟命令提示字元（cmd）或 IDE 終端機，輸入 `node -v` 及 `npm -v`，檢查 Node.js 及 npm 是否已正確安裝。

#在 macOS 上安裝 Node.js

# 步驟 1：使用 Homebrew（建議方式）：開啟終端機。輸入 `brew install node` 並按 Enter。如果尚未安裝 Homebrew，請先在終端機中運行以下命令進行安裝：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
或者使用官方安裝程式：瀏覽 Node.js 官方網站。下載 macOS .pkg 安裝程式。開啟已下載的 .pkg 檔案，並依照提示完成安裝。
# 步驟 2：驗證安裝：開啟命令提示字元（cmd）或 IDE 終端機，輸入 `node -v` 及 `npm -v`，檢查 Node.js 及 npm 是否已正確安裝。

步驟 1：

步驟 1 替代方式：

在終端機中運行以下命令：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

#安裝後，請按照以下步驟操作：

# 步驟 1：下載程式碼包
# 步驟 2：解壓程式碼包
# 步驟 3：使用 IDE 開啟程式碼包，並進入程式碼目錄
# 步驟 4：在 IDE 終端機中運行安裝依賴的命令：npm i
# 步驟 5：在 IDE 終端機中運行啟動開發伺服器的命令：npm run dev -- --host 127.0.0.1
# 步驟 6：如果步驟 5 失敗，請嘗試使用此命令啟動開發伺服器：npx vite --host 127.0.0.1

#如何開發後端服務？

對於具備後端資料儲存功能的應用程式，取得原始碼後，開發者需要整合自己的 Supabase 專案，以進行後續二次開發及管理。

Supabase 官方網站：https://supabase.com/

#在 Supabase 中匯入並執行 SQL

#替換原始碼包中的環境變數

將 .env 檔案中的以下內容替換為你自己的憑證：

• 更新 URL 及 API keys

注意： 將 VITE_SUPABASE_PROXY=true 改為 false。