Xây dựng và xuất bản app Atoms đầu tiên của bạn, từ câu lệnh đầu tiên đến một phiên bản trực tiếp mà bạn có thể chia sẻ.

Bạn không cần phải học mọi agent, chế độ hoặc thuật ngữ kỹ thuật trước khi bắt đầu. Quy trình làm việc cơ bản đơn giản hơn nhiều: nói cho Atoms biết bạn muốn gì, kiểm tra những gì nó đã tạo, thực hiện thay đổi, kiểm thử và xuất bản khi đã sẵn sàng.

Hướng dẫn này sử dụng một website quán cà phê đơn giản làm ví dụ, nhưng cùng một vòng lặp này cũng áp dụng cho trang đích, bảng điều khiển, công cụ nội bộ hoặc ý tưởng app của riêng bạn.

Các bước này áp dụng cho một dự án web trên máy tính đã đăng nhập. Các dự án di động sử dụng quy trình tạo bản dựng và phân phối di động riêng biệt.

Trước khi xuất bản, hãy chờ bản dựng hiện tại hoàn tất, đảm bảo bạn có quyền xuất bản, xác nhận dự án đang ở trạng thái nhàn rỗi và kiểm tra rằng các tài nguyên dự án bắt buộc như tín dụng hoặc dung lượng lưu trữ đều khả dụng. Nếu Publish không khả dụng, hãy kiểm tra phiên bản dự án, quyền truy cập và các điều kiện tài nguyên trước khi thử lại. Các dự án sử dụng dữ liệu, thông tin bí mật, email, AI, thanh toán hoặc các dịch vụ được kết nối khác cũng cần hoàn tất các bước kiểm tra sản xuất trước khi chia sẻ.

Mô tả điều bạn muốn

Bắt đầu trong ô câu lệnh và mô tả kết quả bạn muốn bằng ngôn ngữ thông thường. Bạn không cần viết đặc tả kỹ thuật hoặc nói cho Atoms biết cách viết mã.

Một câu lệnh đầu tiên hữu ích thường nêu rõ bạn đang xây dựng gì, các phần hoặc tính năng chính, định hướng hình ảnh và bất kỳ điều gì quan trọng trên thiết bị di động.

Nếu bạn đã tìm thấy thứ gì đó trong App World gần với điều bạn muốn, bạn cũng có thể bắt đầu bằng cách Remix dự án đó thay vì bắt đầu từ đầu.

Kiểm tra kết quả đầu tiên

Atoms tạo dự án và xây dựng phiên bản đầu tiên. Khi đã sẵn sàng, hãy mở Trình xem App và xem qua kết quả trước khi yêu cầu thêm thay đổi.

Trước tiên hãy kiểm tra nhanh một lượt. Bạn chưa cần cố gắng tìm mọi lỗi nhỏ ngay lúc này. Hãy kiểm tra xem Atoms có hiểu đúng ý chính hay không.

• Các phần và tính năng chính đã có chưa?
• Bố cục tổng thể có khớp với điều bạn yêu cầu không?
• Các nút, liên kết, bộ lọc hoặc tương tác quan trọng khác có phản hồi không?
• Có điều gì rõ ràng là bị thiếu, bị lỗi hoặc khác với điều bạn muốn không?

Bạn có thể xem trước app ở cả chế độ PC và di động, vì vậy hãy kiểm tra trải nghiệm trên nhiều hơn một kích thước màn hình trước khi tiếp tục.

Thực hiện thay đổi

Hãy coi phiên bản đầu tiên là điểm khởi đầu. Nói cho agent biết bạn muốn thay đổi điều gì bằng ngôn ngữ đơn giản, sau đó kiểm tra lại kết quả.

Các yêu cầu nhỏ và cụ thể thường dễ xem xét hơn so với việc thay đổi mọi thứ cùng một lúc.

Đối với thay đổi về hình ảnh, bạn có thể chỉnh sửa trực tiếp các phần tử trong Trình xem App hoặc mô tả thay đổi cho agent. Nếu bạn có ảnh chụp màn hình, thiết kế, tệp hoặc tài liệu tham chiếu khác mà bạn muốn Atoms làm theo, hãy tải lên và chỉ cho agent đến đó.

Khi có thứ gì đó bị lỗi: Nếu có thứ gì đó thực sự bị lỗi thay vì chỉ khác với sở thích của bạn, hãy dùng Fix Bug hoặc nói cho agent biết chính xác điều gì sai và nó xảy ra ở đâu.

Nếu vẫn thất bại: Đừng lặp lại cùng một yêu cầu sau một lần thử lại có trọng tâm. Ghi lại bước bị ảnh hưởng, điều bạn mong đợi, điều đã xảy ra, những gì bạn đã thử và liên kết dự án có thể chia sẻ hoặc ảnh chụp màn hình. Nếu bạn là người dùng trả phí gặp sự cố về tài khoản, thanh toán hoặc nền tảng Atoms, hãy mở Trung tâm trợ giúp Atoms, chọn Atoms Support trong Explore resources, rồi chọn Contact us. Đối với người dùng Gói miễn phí hoặc các hướng dẫn sản phẩm và khắc phục sự cố thông thường, hãy bắt đầu với Trung tâm trợ giúp, Ask Assistant hoặc cộng đồng Atoms.

Kiểm thử trước khi xuất bản

Trước khi gửi app cho bất kỳ ai, hãy dành vài phút sử dụng nó như một khách truy cập thực sự. Kiểm thử nhanh ngay bây giờ sẽ dễ hơn nhiều so với việc giải thích một liên kết bị lỗi sau khi bạn chia sẻ nó.

• Nhấp vào mọi nút và liên kết quan trọng.
• Thử các phần tương tác, chẳng hạn như bộ lọc, biểu mẫu, menu hoặc điều hướng.
• Kiểm tra cả chế độ xem PC và di động.
• Tìm văn bản bị cắt, chồng lấn, thiếu hoặc khó đọc.
• Đảm bảo hành trình người dùng chính hoạt động từ đầu đến cuối.

Nếu app của bạn phụ thuộc vào dữ liệu được lưu trữ hoặc các hành động backend, hãy kiểm thử cả những phần đó. Atoms có thể sử dụng Atoms Cloud hoặc kết nối với Kết nối Supabase cho các khả năng như lưu trữ dữ liệu, thông tin bí mật, email, lệnh gọi AI và thanh toán.

Trước khi xuất bản, hãy xóa thông tin bí mật, mật khẩu, token, thông tin cá nhân và dữ liệu kiểm thử riêng tư khỏi bất kỳ thứ gì khách truy cập có thể nhìn thấy. Xác nhận xem dự án nên là Public hay Private, và kiểm thử liên kết trực tiếp bằng tài khoản dự định sử dụng. Nếu app dùng thanh toán thật, email, dữ liệu được lưu trữ hoặc các dịch vụ được kết nối, hãy xác minh riêng các hành động sản xuất đó trước khi chia sẻ.

Xuất bản

Khi bản xem trước trông đúng và các tương tác chính hoạt động, hãy nhấp vào Publish ở góc trên bên phải của trình chỉnh sửa.

Việc xuất bản tạo ra một liên kết trực tiếp mà quyền truy cập phụ thuộc vào chế độ hiển thị bạn chọn. Public có thể được mở bằng liên kết và có thể xuất hiện trong Discover. Private chỉ hiển thị với chủ sở hữu và có thể bị giới hạn theo gói. Hãy chọn chế độ hiển thị dự định trước khi chia sẻ và kiểm thử liên kết bằng tài khoản dự định sử dụng.

Xuất bản là thời điểm dự án của bạn trở thành thứ mà người khác thực sự có thể mở. Hãy tiếp tục phát triển trong dự án, nhưng luôn kiểm tra riêng phiên bản trực tiếp sau khi bạn xuất bản.

Xác minh app trực tiếp

Hãy tự mở liên kết đã xuất bản trước khi chia sẻ. Xác nhận rằng chế độ hiển thị Public hoặc Private đã chọn cung cấp quyền truy cập cho đúng đối tượng; hãy dùng cửa sổ riêng tư hoặc tài khoản dự định để kiểm thử.

• Mở liên kết trong tab mới hoặc cửa sổ riêng tư bằng tài khoản hoặc ngữ cảnh truy cập phù hợp với đối tượng dự định.
• Xác nhận trang tải thành công và hiển thị phiên bản bạn mong đợi.
• Lặp lại các lần nhấp hoặc tương tác quan trọng nhất.
• Kiểm tra trang trên điện thoại nếu khách truy cập di động quan trọng đối với app của bạn.

Nếu bạn phát hiện vấn đề, hãy quay lại dự án, thực hiện thay đổi, kiểm thử lại bản xem trước, rồi cập nhật phiên bản trực tiếp.

Cập nhật sau khi bạn thực hiện thay đổi

App của bạn không ngừng thay đổi chỉ vì bạn đã xuất bản nó một lần. Hãy tiếp tục tinh chỉnh nó trong dự án bất cứ khi nào bạn cần.

Sau lần xuất bản đầu tiên, nút Publish sẽ trở thành Update. Nhấp vào Update khi bạn muốn đẩy các thay đổi mới lên phiên bản trực tiếp.

Sau khi cập nhật, hãy mở liên kết đã xuất bản thêm một lần nữa và xác minh nó. Điều đó mang lại cho bạn một vòng lặp đơn giản có thể lặp lại:

Mô tả → Kiểm tra → Thay đổi → Kiểm thử → Xuất bản → Xác minh → Cập nhật

Đó là quy trình làm việc cốt lõi của Atoms. Các app phức tạp hơn có thể thêm dữ liệu, xác thực, tích hợp, miền tùy chỉnh hoặc nhiều agent, nhưng vòng lặp xây dựng vẫn giữ nguyên.