expo-dev-client

expo-dev-client skill 概覽

expo-dev-client 的用途

expo-dev-client skill 會先幫你判斷是否真的需要 Expo development client，再引導你用 EAS Build 在本機或透過 TestFlight 完成設定與建置。它真正的價值不只是「做出一個 build」，而是「在不用自己反覆翻 Expo 文件與猜設定的情況下，把支援自訂原生能力的測試 app 安裝到真機上」。

哪些人適合使用這個 skill

這個 skill 特別適合：

• 正在為 Expo 專案加入 native modules 的團隊
• 需要測試本地 Expo modules 或自訂原生程式碼的開發者
• 使用 Apple 專屬 target，例如 widgets、app clips 或 extensions 的 app
• 需要建立可重複執行的內部 iOS 測試流程，並透過 TestFlight 發送給團隊的團隊

如果你的 app 在 Expo Go 裡就能完整運作，通常不需要這個 skill。

安裝前最重要的判斷

採用前最關鍵的問題其實很簡單：你到底需不需要 development client？expo-dev-client skill 的價值就在於，它會很早就先幫你回答這件事。它會明確建議你先用 npx expo start 試跑 Expo Go，避免浪費建置時間，也避免過早引入不必要的 EAS 複雜度。

expo-dev-client 與一般 Expo 提示詞有何不同

一般提示詞可能只會叫代理「幫我把 Expo dev client 設好」，但這個 skill 更偏向決策導向。它聚焦在：

• 什麼情況才算真的需要 dev client
• eas.json 應具備的必要結構
• 本機建置與雲端 / TestFlight 建置之間的差異
• 在實機上做接近部署情境測試時，實際該走哪些指令流程

因此，比起泛用型 Expo 助手提示詞，它更適合用在 setup 與接近 release 的工作流程。

如何使用 expo-dev-client skill

安裝 expo-dev-client skill

在支援 skills 的環境中，使用以下指令安裝：

npx skills add https://github.com/expo/skills --skill expo-dev-client

由於這個 skill 內容精簡、重點主要集中在 SKILL.md，安裝的核心目的其實是讓它能在 Expo 原生測試相關工作中重複使用。

先定義要完成的工作，不要只下指令

在呼叫 expo-dev-client skill 之前，先把真正目標說清楚：

• 「我剛加入一個 native SDK，需要在 iPhone 上測試」
• 「我們需要一個給 QA 用、對應特定 branch 的 dev client」
• 「app 現在加入了 widget，所以 Expo Go 已經不夠」
• 「我們想要一個透過 TestFlight 發送的 iOS development build」

這很重要，因為這個 skill 在「確定你真的有自訂原生需求」時表現最好。

先確認 Expo Go 是否已經足夠

很多人常見的錯誤，是太早就開始用 expo-dev-client。建議的第一步測試是：

npx expo start

如果你的 app 在 Expo Go 中運作正常，就先停在這裡。development client 會增加建置時間、簽章需求，以及發佈與分送成本。只有在原生能力真的迫使你往下走時，才需要用這個 skill。

哪些情況最適合用 expo-dev-client

當你的專案包含以下內容時，就適合使用 expo-dev-client：

• 本地 Expo modules
• 自訂原生程式碼
• Expo Go 不支援的第三方 native modules
• Apple targets，例如 widgets、app clips 或 extensions

這些情況下，dev client 會從「可選」變成「必要」。

先準備代理真正需要的最低資訊

如果你想讓代理更有效地使用 expo-dev-client skill，請先提供：

• 目標平台：ios、android 或兩者
• 預期的發佈方式：本機安裝、內部測試，或 TestFlight
• 專案是否已經完成 EAS 設定
• 目前的 eas.json
• app 是否使用 Expo Go 不支援的 native modules
• 任何版本管理或簽章限制

如果沒有這些背景，代理仍然可以提供指令建議，但可能抓不到正確的 build profile，或給出過度配置的建議。

不要只說「set up expo-dev-client」

一個太弱的提示詞：

Set up expo-dev-client.

一個更好的提示詞：

Use the expo-dev-client skill to determine whether this Expo app needs a dev client. We added a third-party native iOS SDK and need a TestFlight-distributed development build for internal QA. Review this eas.json, identify missing settings, and give the exact commands for building and submitting.

這種寫法更有效，原因在於：

• 它先要求確認是否真的適合使用
• 它明確指出原生需求觸發點
• 它指定了目標工作流程
• 它提供了可供具體修正的設定內容

正確設定 eas.json

這個 skill 最關鍵的設定重點，是建立一個包含 developmentClient: true 的 development build profile，通常也會搭配版本自動化：

{
  "cli": {
    "version": ">= 16.0.1",
    "appVersionSource": "remote"
  },
  "build": {
    "production": {
      "autoIncrement": true
    },
    "development": {
      "autoIncrement": true,
      "developmentClient": true
    }
  },
  "submit": {
    "production": {},
    "development": {}
  }
}

重要欄位如下：

• developmentClient: true：告訴 EAS 這次要打包 development client
• autoIncrement: true：降低 build number 管理上的摩擦
• appVersionSource: "remote"：讓版本號透過 EAS 維持一致

需要遠端真機測試時，優先考慮用 TestFlight 建置

對 iOS 團隊來說，最有價值的 expo-dev-client usage 路徑通常就是 TestFlight：

eas build -p ios --profile development --submit

當你需要的是能分送給測試人員、具備 dev 能力的 app，而不只是本機產物時，這就是最實用的「expo-dev-client for Deployment」流程。它把雲端建置與提交串在一起，通常比自己拼湊多個分開步驟更快。

當你更重視速度或隱私時，使用本機建置

如果你不需要 TestFlight，本機建置可能會是更合適的工作流程：

• 在某些環境下迭代更快
• 對本機工具鏈有更高控制權
• 適合在更大範圍內部發送之前，先做裝置測試

如果你正在除錯 setup，或只是要在自己的裝置上驗證原生整合，請選本機建置。若你需要和 QA 或非技術測試者協作，則更適合選擇 TestFlight。

先看對的 repository 檔案

這個 skill 很單純：先從 SKILL.md 開始。這個 skill 路徑下沒有額外的支援目錄，例如 resources/、rules/ 或 helper scripts，所以大部分可用資訊都已集中在這個檔案裡。

這也代表你不應期待它內含很深的自動化邏輯；它主要是一份實務導向的決策與工作流程指南。

真實專案建議採用的流程

一套可靠的 expo-dev-client guide 工作流程如下：

1. 先確認 Expo Go 是否因為原生限制而無法使用。
2. 檢查或建立 eas.json。
3. 新增一個包含 developmentClient: true 的 development profile。
4. 在本機建置與 TestFlight 發佈之間做選擇。
5. 針對你的平台執行精確的 EAS build 指令。
6. 在真機上測試。
7. 如果版本號或提交行為不對，再回頭檢查 profile 設定。

這樣的順序能減少浪費掉的建置循環，也能及早抓出「其實根本不需要 dev client」的情況。

expo-dev-client skill 常見問題

expo-dev-client 只適合較進階的 Expo app 嗎？

大致上是。新手也能用，但這個 skill 最有幫助的時機，通常是 app 因為原生需求而超出 Expo Go 能力範圍之後。如果你還停留在純 managed workflow 階段，它目前未必能帶來太多價值。

expo-dev-client 是否等同於在專案裡安裝 expo-dev-client？

不是。expo-dev-client skill 著重的是 development-client build 周邊的工作流程指引。它幫你判斷何時該用、如何設定 EAS，以及該怎麼選擇建置路徑，而不只是提醒你安裝某個 package。

什麼情況下不該使用 expo-dev-client skill？

以下情況不建議使用：

• 你的 app 在 Expo Go 裡已經能正常運作
• 你只需要 JavaScript 層級的迭代
• 你要找的是完整 release build 指南，而不是 development-client setup
• 你的問題與原生能力或 build 分送無關

它和一般 Expo 疑難排解提示詞有什麼差別？

一般提示詞往往只會產出很泛的 build 建議。expo-dev-client skill 範圍更聚焦，因此更適合用來協助安裝與採用判斷：它特別強調「到底需不需要 dev client？」這個檢查點，以及經常成為導入阻礙的精確 EAS profile 細節。

expo-dev-client 對 Android 也有幫助嗎？

有，但目前 skill 片段中最明確、最完整的指引仍然集中在 iOS 與 TestFlight。不過底層邏輯同樣適用於 Android development builds：只要有自訂原生程式碼，且 Expo Go 不足以支援，就可能需要 dev client。

這個 skill 適合 deployment workflow 嗎？

可以，但要理解它的界線。expo-dev-client for Deployment 更準確地說，是針對 development build 的內部分送流程，尤其適合 QA 或 branch 測試時透過 TestFlight 發送；它不能取代完整的正式版發佈規劃。

如何改善 expo-dev-client skill 的使用效果

一開始就提供目前專案狀態

想讓 expo-dev-client skill 產出更好的結果，請一開始就附上：

• 你的 eas.json
• 目標裝置與平台
• 這次是只做本機安裝，還是要走 TestFlight
• 是哪個 native module 或 target 迫使你做這個改變
• 是否已經先試過 Expo Go

這樣代理才能從泛泛建議，進一步給出精確修改與對應指令。

先問判斷，再問步驟

高品質提示詞可以從這句開始：

First determine whether this app truly needs expo-dev-client.

這一句就能明顯提升輸出品質，因為這個 skill 的核心價值，就是避免你做了其實不必要的 dev-client setup。

附上設定片段讓代理檢查

如果你把現有的 eas.json 貼出來，代理就可以：

• 找出是否缺少 developmentClient: true
• 建議版本管理的修正
• 對齊 submit 與 build profiles
• 避免憑空補出你其實不需要的設定

這比從零開始發問有效得多。

明確說出你要的發佈方式

正確指令會依你的目標而不同，你可能要的是：

• 本機 development build
• 可安裝到裝置上的雲端 build
• 已提交到 TestFlight 的 iOS build

如果你沒先說清楚，第一次得到的答案可能技術上沒錯，但在團隊實際操作上完全不對。

留意最常見的失敗模式

最常見的失敗情況，是把 expo-dev-client 用在本來就該留在 Expo Go 的 app。第二常見的問題，是 EAS 設定資訊給得太少，最後又怪 skill 輸出太模糊。這兩種情況其實都能避免，只要你把原生需求與目前設定先交代清楚。

拿到第一版答案後繼續迭代

收到第一輪回覆後，可以繼續追問，例如：

• 「Validate this eas.json against a dev-client TestFlight workflow.」
• 「Rewrite the build commands for Android only.」
• 「Assume our app uses a widget extension; what changes the decision?」
• 「Minimize the setup to the smallest working development profile.」

這樣能把 expo-dev-client skill 從一般說明，推進到真正符合專案情境的執行層次。

用標準提示詞提升團隊採用一致性

如果有多位開發者都會使用這個 skill，建議建立一份可重用的內部提示詞模板，例如：

Use expo-dev-client to assess whether this Expo app requires a development client. Here is our eas.json, target platform, distribution goal, and native dependency list. Return: 1) decision, 2) config changes, 3) exact commands, 4) likely blockers.

這能讓輸出結果更一致，也能降低新人上手成本。

把 expo-dev-client skill 當成關卡，而不只是食譜

改善 expo-dev-client usage 的最佳方式，是把它當成建置前的決策關卡。如果團隊總是在已經決定要做 dev client 之後才使用這個 skill，你就會失去它最大的優勢：避免不必要的原生建置流程負擔。