expo-dev-client

Tổng quan về skill expo-dev-client

expo-dev-client làm gì

Skill expo-dev-client giúp bạn xác định liệu bạn có thực sự cần một Expo development client hay không, rồi hướng dẫn cách cấu hình và build bằng EAS Build trên máy cục bộ hoặc đưa lên TestFlight. Giá trị thực của skill này không chỉ là “tạo một bản build”, mà là “đưa một app test có hỗ trợ native tùy chỉnh lên thiết bị thật mà không phải mò mẫm qua tài liệu Expo.”

Ai nên dùng skill này

Skill này phù hợp nhất với:

• các team Expo đang thêm native modules
• lập trình viên cần test local Expo modules hoặc custom native code
• app dùng các target riêng của Apple như widget, app clip hoặc extension
• team cần một quy trình ổn định, có thể lặp lại để test nội bộ iOS qua TestFlight

Nếu app của bạn chạy hoàn toàn trong Expo Go, thường sẽ không cần skill này.

Quyết định cài đặt quan trọng nhất

Câu hỏi lớn nhất trước khi dùng là rất đơn giản: bạn có cần development client hay không? Skill expo-dev-client có giá trị vì nó trả lời câu hỏi này từ sớm. Nó chủ động khuyến nghị bạn thử Expo Go trước bằng npx expo start, nhờ đó tránh mất thời gian build và không tự làm phức tạp quy trình với EAS khi chưa cần thiết.

Điều gì khiến expo-dev-client khác với một prompt Expo chung chung

Một prompt chung có thể chỉ bảo agent “set up Expo dev client”, còn skill này thiên về ra quyết định hơn. Nó tập trung vào:

• ngưỡng nào thì cần dev client
• cấu trúc eas.json bắt buộc
• khác biệt giữa build local và build cloud/TestFlight
• chuỗi lệnh thực tế cho kiểu test gần với triển khai trên thiết bị thật

Vì vậy, nó hữu ích hơn cho các tác vụ setup và workflow cận phát hành so với một prompt Expo tổng quát.

Cách dùng skill expo-dev-client

Cài đặt skill expo-dev-client

Cài skill này trong môi trường hỗ trợ skills bằng lệnh:

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

Vì skill này gọn và tập trung chủ yếu trong SKILL.md, việc cài đặt chủ yếu là để có thể tái sử dụng nó trong các tác vụ test native với Expo.

Bắt đầu từ mục tiêu công việc, không phải từ câu lệnh

Trước khi gọi skill expo-dev-client, hãy xác định rõ mục tiêu thực tế:

• “Tôi vừa thêm một native SDK và cần test trên iPhone”
• “Team cần một dev client theo từng branch cho QA”
• “App hiện có widget nên Expo Go không còn đủ nữa”
• “Chúng tôi muốn một iOS development build được phân phối qua TestFlight”

Điều này quan trọng vì skill phát huy hiệu quả nhất khi nhu cầu dùng custom native code đã rõ ràng.

Trước tiên hãy kiểm tra xem Expo Go có đủ dùng không

Một lỗi rất thường gặp là dùng expo-dev-client quá sớm. Bài test được khuyến nghị đầu tiên là:

npx expo start

Nếu app của bạn chạy được trong Expo Go, hãy dừng ở đó. Development client sẽ kéo theo thời gian build, yêu cầu signing và chi phí phân phối bổ sung. Chỉ nên dùng skill này khi khả năng native thực sự buộc bạn phải đi thêm bước đó.

Nắm rõ các dấu hiệu cho thấy expo-dev-client là lựa chọn phù hợp

Hãy dùng expo-dev-client khi project của bạn có:

• local Expo modules
• custom native code
• third-party native modules không có trong Expo Go
• các target của Apple như widget, app clips hoặc extensions

Trong những trường hợp này, dev client không còn là “tùy chọn” mà chuyển thành “bắt buộc”.

Chuẩn bị bộ thông tin tối thiểu để agent xử lý đúng

Nếu muốn agent dùng skill expo-dev-client hiệu quả, hãy cung cấp:

• nền tảng đích: ios, android, hoặc cả hai
• cách phân phối mong muốn: cài local, test nội bộ, hay TestFlight
• app đã cấu hình EAS hay chưa
• eas.json hiện tại của bạn
• app có dùng native modules mà Expo Go không hỗ trợ hay không
• các ràng buộc về versioning hoặc signing

Nếu thiếu ngữ cảnh này, agent vẫn có thể gợi ý lệnh, nhưng dễ chọn sai build profile hoặc đề xuất thừa phần setup.

Dùng prompt tốt hơn thay vì chỉ nói “set up expo-dev-client”

Một prompt yếu:

Set up expo-dev-client.

Một prompt tốt hơn:

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.

Vì sao prompt này hiệu quả hơn:

• nó yêu cầu xác thực độ phù hợp trước
• nó nêu rõ yếu tố native kích hoạt nhu cầu
• nó chỉ định workflow mục tiêu
• nó cung cấp config để có thể chỉnh sửa cụ thể

Cấu hình eas.json đúng cách

Cấu hình quan trọng nhất mà skill này làm nổi bật là một build profile cho development với developmentClient: true, thường đi kèm với tự động tăng phiên bản:

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

Các trường quan trọng là:

• developmentClient: true: yêu cầu EAS đóng gói development client
• autoIncrement: true: giảm rắc rối liên quan đến build number
• appVersionSource: "remote": giữ versioning nhất quán thông qua EAS

Build cho TestFlight khi cần test từ xa trên thiết bị thật

Với các team iOS, hướng expo-dev-client usage có giá trị nhất thường là TestFlight:

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

Đây là luồng “expo-dev-client for Deployment” thực tế khi bạn cần một app có khả năng dev được phân phối cho tester, chứ không chỉ là một artifact cục bộ. Nó kết hợp build trên cloud và submit trong một bước, thường nhanh hơn so với việc tự ghép nhiều bước riêng lẻ.

Dùng local build khi tốc độ hoặc quyền riêng tư quan trọng

Nếu bạn không cần TestFlight, local build có thể là workflow tốt hơn:

• lặp nhanh hơn trong một số môi trường
• kiểm soát tốt hơn đối với local tooling
• hữu ích để test trên thiết bị trước khi rollout nội bộ rộng hơn

Hãy chọn local khi bạn đang debug phần setup hoặc xác minh một tích hợp native trên thiết bị của chính mình. Chọn TestFlight khi bạn cần phối hợp với QA hoặc những người test không chuyên kỹ thuật.

Đọc đúng file trong repository ngay từ đầu

Skill này khá đơn giản: hãy bắt đầu với SKILL.md. Trong đường dẫn skill này không có thêm các thư mục hỗ trợ như resources/, rules/ hay script trợ giúp, nên phần lớn hướng dẫn hữu ích đã được gom sẵn ở đó.

Điều này cũng có nghĩa là bạn không nên kỳ vọng có logic tự động hóa quá sâu; đây chủ yếu là một hướng dẫn thực tế về quyết định và workflow.

Quy trình expo-dev-client nên áp dụng cho dự án thực tế

Một workflow expo-dev-client guide đáng tin cậy là:

1. Xác nhận xem Expo Go có thất bại vì lý do native hay không.
2. Rà soát hoặc tạo eas.json.
3. Thêm profile development với developmentClient: true.
4. Quyết định giữa local build và phân phối qua TestFlight.
5. Chạy đúng lệnh EAS build cho nền tảng của bạn.
6. Test trên thiết bị thật.
7. Xem lại thiết lập profile nếu versioning hoặc hành vi submit có vấn đề.

Thứ tự này giúp giảm số vòng build lãng phí và phát hiện sớm trường hợp “thực ra không cần dev client”.

Câu hỏi thường gặp về skill expo-dev-client

expo-dev-client chỉ dành cho các app Expo nâng cao?

Phần lớn là vậy. Người mới vẫn có thể dùng, nhưng skill này phù hợp nhất khi app đã vượt khỏi khả năng của Expo Go vì các yêu cầu native. Nếu bạn vẫn đang ở phạm vi managed workflow thuần, có thể nó chưa mang lại nhiều giá trị.

expo-dev-client có giống với việc chỉ cài expo-dev-client vào project không?

Không. Skill expo-dev-client là phần hướng dẫn cho workflow xung quanh các bản build development client. Nó giúp bạn xác định khi nào nên dùng, cấu hình EAS ra sao và chọn đường build phù hợp thế nào. Nó không chỉ đơn giản là một lời nhắc cài package.

Khi nào không nên dùng skill expo-dev-client?

Không nên dùng khi:

• app của bạn đã chạy tốt trong Expo Go
• bạn chỉ cần lặp ở mức JavaScript
• bạn đang cần một hướng dẫn full release build thay vì setup development client
• vấn đề của bạn không liên quan đến khả năng native hoặc phân phối bản build

Skill này khác gì với một prompt xử lý sự cố Expo thông thường?

Một prompt thông thường có thể trả về lời khuyên build khá chung chung. expo-dev-client skill hẹp hơn nên làm tốt hơn ở khâu hướng dẫn quyết định cài đặt: nó nhấn mạnh checkpoint “có cần dev client hay không?” và chi tiết chính xác trong EAS profile — những điểm thường làm người dùng mắc kẹt khi bắt đầu áp dụng.

expo-dev-client có hữu ích cho Android không?

Có, nhưng phần hướng dẫn rõ ràng nhất trong nội dung skill hiện tại chủ yếu xoay quanh iOS và TestFlight. Tuy vậy, logic cốt lõi vẫn áp dụng cho Android development builds khi custom native code khiến bạn phải dùng dev client thay vì Expo Go.

Skill này có phù hợp cho workflow triển khai không?

Có, nhưng trong giới hạn nhất định. expo-dev-client for Deployment nên được hiểu là phân phối nội bộ các development build, đặc biệt qua TestFlight cho QA hoặc test theo branch. Nó không thay thế cho việc lập kế hoạch phát hành production đầy đủ.

Cách cải thiện việc dùng skill expo-dev-client

Cung cấp trạng thái hiện tại của project ngay từ đầu

Để nhận kết quả tốt hơn từ skill expo-dev-client, hãy kèm theo:

• eas.json của bạn
• thiết bị đích và nền tảng
• đây là local-only hay TestFlight
• native module hoặc target nào khiến bạn phải thay đổi
• bạn đã thử Expo Go hay chưa

Nhờ vậy agent có thể đi từ gợi ý chung sang chỉnh sửa và câu lệnh cụ thể.

Hãy yêu cầu ra quyết định trước khi yêu cầu các bước

Một prompt chất lượng cao nên bắt đầu bằng:

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

Chỉ một chỉ dẫn này thôi cũng cải thiện chất lượng đầu ra đáng kể, vì giá trị lớn nhất của skill là tránh setup dev-client khi không cần.

Đính kèm đoạn config để được review

Nếu bạn dán eas.json hiện có, agent có thể:

• phát hiện thiếu developmentClient: true
• đề xuất chỉnh versioning
• căn chỉnh profile submit và build
• tránh bịa ra cấu hình mà bạn không cần

Cách này tốt hơn nhiều so với hỏi từ đầu mà không có dữ liệu.

Nói rõ mục tiêu phân phối

Lệnh đúng sẽ phụ thuộc vào việc bạn muốn:

• một local development build
• một cloud build để cài lên thiết bị
• một iOS build được submit lên TestFlight

Nếu bạn không nói rõ, đầu ra đầu tiên có thể đúng về mặt kỹ thuật nhưng lại sai về mặt vận hành đối với team của bạn.

Chú ý đến kiểu thất bại phổ biến nhất

Lỗi thường gặp nhất là dùng expo-dev-client cho những app lẽ ra nên tiếp tục ở Expo Go. Lỗi thứ hai là mô tả cấu hình EAS quá sơ sài rồi lại cho rằng skill trả lời mơ hồ. Cả hai đều có thể tránh được nếu bạn cung cấp rõ yêu cầu native và config hiện tại.

Lặp lại sau câu trả lời đầu tiên

Sau phản hồi đầu tiên, hãy hỏi tiếp những câu như:

• “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.”

Cách này giúp đẩy expo-dev-client skill từ mức giải thích chung sang thực thi sát với dự án của bạn.

Chuẩn hóa prompt để team dễ áp dụng hơn

Nếu nhiều lập trình viên trong team sẽ dùng skill này, hãy tạo một mẫu prompt nội bộ có thể tái sử dụng, ví dụ:

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.

Làm vậy sẽ giúp đầu ra nhất quán hơn và giảm thời gian làm quen cho thành viên mới.

Dùng skill như một cổng quyết định, không chỉ như công thức làm theo

Cách tốt nhất để cải thiện expo-dev-client usage là xem nó như một bước chặn để ra quyết định trước khi build. Nếu chỉ dùng skill sau khi team đã mặc định chọn dev client, bạn sẽ mất lợi ích lớn nhất của nó: tránh gánh thêm chi phí workflow native-build khi thực ra chưa cần.