Bỏ qua để vào nội dung chính
Đưa web app lên iPhone qua TestFlight: lộ trình đầy đủ

Đưa web app lên iPhone qua TestFlight: lộ trình đầy đủ

Bởi Lucas Fischer
14 thg 11, 20268 phút đọc

Từ web app đến bản build cài được trên iPhone qua TestFlight: tài khoản Apple, Universal Links, asset bắt buộc và những chỗ Apple hay từ chối.

Bạn có một web app chạy tốt trên Chrome, và sếp hoặc người dùng hỏi: "Sao không có app trên iPhone?" Bạn mở Xcode lần đầu, thấy certificate, provisioning profile, archive, rồi đóng lại. Bài này đi thẳng đường: từ web app đến bản build cài được trên iPhone qua TestFlight, kèm những chỗ Apple hay chặn mà tài liệu chính thức không nói trước.

Bước 0: tài khoản Apple phải ở trạng thái active, không phải pending

Đây là chỗ hỏng sớm nhất và tốn thời gian nhất. Để upload build lên TestFlight, bạn cần Apple Developer Program membership đang hoạt động. Hướng dẫn gốc nói rõ: một Apple Account thường, hoặc một đơn đăng ký còn ở trạng thái Pending, đều không đủ. Bạn phải đăng ký qua Apple, hoàn tất bước xác minh và thanh toán, rồi chờ Apple xác nhận membership trước khi kết nối tài khoản đó vào bất kỳ công cụ build nào. Phí là 99 USD/năm, có giá theo khu vực ở một số nước.

Thực tế: bước duyệt của Apple không nằm trong tầm kiểm soát của bạn và không nên giả định là xong trong ngày. Cứ đăng ký trước, rồi tiếp tục code web app trong lúc chờ — bạn không bị chặn ở bước nào khác.

Hiểu đúng TestFlight trước khi dùng

Nhiều người nhầm TestFlight với "phát hành". Không phải. Một iOS build là bản app đã đóng gói để cài lên iPhone; TestFlight là dịch vụ của Apple để phân phối bản build đó cho tester. Hướng dẫn gốc nói thẳng: upload một build lên TestFlight không công khai app đó trên App Store.

Điều này quan trọng với cách bạn lập kế hoạch. Bạn có thể đưa app vào tay 5 người thật, sửa, đưa lại — tất cả trước khi chạm vào quy trình review công khai.

Cái gì bắt buộc build lại, cái gì không

Mỗi lần build native đều tốn thời gian, và trên một số nền tảng còn tốn quota. Nên phân biệt rõ:

  • Cần build mới khi bạn muốn thay đổi xuất hiện trong app đã cài: giao diện, styling, điều hướng, app icon, splash screen, native status bar, permissions, hoặc các tính năng native.
  • Không cần build mới cho thay đổi phần listing App Store: screenshot, ảnh quảng bá, mô tả, keyword và giá. Những thứ đó quản lý riêng trong App Store Connect.

Riêng permissions nằm ở nhóm trên là chi tiết dễ quên: sửa một dòng mô tả quyền camera cũng là một lần build lại.

Universal Links là cơ chế để một link web mở thẳng vào màn hình tương ứng trong app đã cài; máy chưa cài thì link mở website như bình thường. Đây là phần nhiều người làm sau, rồi phải build lại lần nữa.

Hướng dẫn gốc đặt nó trước build đầu tiên, với lý do cụ thể: vì Universal Links đã được cấu hình trước, phần native config đã nằm sẵn trong bản build — không cần tạo build thứ hai chỉ để thêm Universal Links.

Phía website, bạn phải phục vụ file apple-app-site-association tại https://<domain>/.well-known/apple-app-site-association, dùng đúng Apple Team ID và bundle ID, và chỉ match những path bạn muốn. Yêu cầu kỹ thuật rất khắt khe và sai một cái là im lặng không hoạt động: file không có phần mở rộng, trả về JSON hợp lệ với đúng content type, và truy cập công khai được mà không qua redirect.

Cách kiểm tra trước khi build, theo đúng tiêu chí trong hướng dẫn: gọi endpoint đó và xác nhận nó trả HTTP 200, JSON hợp lệ, Content-Type: application/json, và không có redirect. Nếu domain của bạn đứng sau CDN hoặc reverse proxy, hãy kiểm tra kỹ điều kiện "không redirect".

Asset và quyền native: các con số cụ thể

Chuẩn bị trước những thứ này để không phải build lại:

Hạng mụcYêu cầu
App iconPNG 1024 × 1024, không trong suốt, không bo góc sẵn
Splash screenPNG 2732 × 2732, logo ở giữa, chừa nhiều khoảng trống quanh logo để không bị cắt mất trên các màn hình khác nhau
Ảnh người dùng uploadResize tối đa 1600px cạnh dài và chuyển sang JPEG, để ảnh HEIC của iPhone và ảnh điện thoại dung lượng lớn đều chạy
Local notification IDSố nguyên dưới 2.000.000.000

Về quyền: xin quyền đúng lúc người dùng chạm vào tính năng, không xin khi mở app. Hướng dẫn gốc mô tả hai mẫu cụ thể — quyền vị trí chỉ xin ở chế độ "while in use", kèm câu giải thích dạng "We use your location to find gift shops near you"; quyền thông báo chỉ xin lần đầu người dùng bấm "Set reminder", không bao giờ xin lúc khởi động app. Câu mô tả quyền được đóng vào bản build native, nên viết sai là phải build lại.

Một cảnh báo về thanh toán

Nếu app có gói trả phí, đừng giả định subscription trên website là xong. In-App Purchase của Apple cần một phần tích hợp riêng trong app, cộng với các sản phẩm subscription được cấu hình trong App Store Connect. Sau đó TestFlight có hỗ trợ test mua hàng của Apple mà không tính tiền tester — nhưng đó là một hạng mục công việc riêng, không phải một checkbox.

Đẩy lên TestFlight và mời tester

Khi build xong, mở App Store Connect và chọn app của bạn, vào tab TestFlight rồi chờ Apple xử lý xong bản build. Trả lời các câu hỏi về export compliance nếu được hỏi. Build sẵn sàng thì bạn mời người test.

Phía người test: cài app TestFlight từ App Store, mở email lời mời trên iPhone, bấm "View in TestFlight", và đăng nhập đúng Apple Account đã được mời. Lời mời gắn với một Apple Account cụ thể, nên đăng nhập sai tài khoản là không thấy app đâu.

Chỗ Apple hay từ chối, kể cả khi app chạy đúng

Một lập trình viên iOS đã ghi lại công khai lịch sử review của app Ultenix phiên bản 1.0.0, và nó là ví dụ tốt về việc app chạy được vẫn bị chặn: nộp ngày 1/10 kèm video quay từ iPhone simulator; ngày 10/10 bị từ chối vì Apple yêu cầu video quay trên thiết bị thật; ngày 23/10 bị từ chối lần nữa theo guideline 2.1, lần này Apple muốn thấy app hoạt động với thiết bị ngoài mà nó kết nối tới.

Theo ghi chép của chính tác giả, bản sửa ngày 10/10 chỉ đúng một nửa: anh ấy quay trên iPhone thật, nhưng quay chế độ demo có sẵn, không phải kết nối thật. Rút ra được hai việc rất cụ thể cho bạn:

  • Video gửi cho Apple nên quay trên máy thật, và phải thể hiện luồng thật, không phải demo mode.
  • Nếu bạn cần quay lại các hộp thoại xin quyền, hãy gỡ app ra rồi cài lại trước khi quay. Như ghi chép đó nêu: iOS nhớ các quyền đã cấp, nên nếu không gỡ cài đặt, những hộp thoại mà Apple muốn thấy sẽ không bao giờ xuất hiện.

Khi nào chuyển từ TestFlight sang review công khai

Khi app chạy ổn định qua TestFlight, mở nó trong App Store Connect, hoàn tất listing, screenshot, phần privacy details và review information, rồi chọn đúng bản build bạn đã test. Bấm Add for Review, kiểm tra lại bản nháp submission, rồi bấm Submit for Review.

Về công cụ: hỏi đúng câu hỏi về quota

Hướng dẫn gốc dùng nền tảng Floot để sinh bản build iOS từ web app. Điểm đáng lưu ý không phải là công cụ nào, mà là mô hình quota: theo bài viết đó, Floot cho 2 lượt build mobile mỗi tháng ở gói Free, 12 ở gói Pro và không giới hạn ở gói Power, còn chế độ Test mode dùng preview server và app ngừng chạy sau bốn tiếng kể từ lúc publish.

Dù bạn chọn Capacitor tự dựng, một nền tảng no-code hay Xcode thuần, hãy hỏi trước: một lần build tốn gì, và còn bao nhiêu lần trong tháng? Thứ tự công việc trong bài này — asset, quyền, Universal Links, rồi mới build — chính là cách để lần build đầu tiên không bị lãng phí.

Làm gì tiếp

  • Kiểm tra trạng thái membership Apple hôm nay, trước khi viết thêm dòng code nào.
  • Chuẩn bị icon 1024 × 1024 và splash 2732 × 2732 trong lúc chờ Apple duyệt.
  • Dựng file apple-app-site-association và tự test bằng curl -I cho đến khi thấy 200, đúng content type, không redirect.
  • Viết sẵn kịch bản quay video review trên máy thật, có bước gỡ cài đặt để các hộp thoại quyền xuất hiện.

Không spam, hủy đăng ký bất kỳ lúc nào.

Bài viết liên quan