Gói
Bộ khởi động & SDK demos
Sao chép trang
Tạo ứng dụng Lia với cài đặt terminal được hướng dẫn, đăng nhập được duyệt bởi trình duyệt và đăng ký ứng dụng riêng tự động. Chọn từ chín tích hợp khung công cụ.
#Tạo một dự án
npm create @lia-labs/app@latestLia Developer Studio hướng dẫn bạn qua dự án, khung công cụ, mẫu, cài đặt và tài khoản. Sử dụng phím mũi tên để chọn khung công cụ và Khởi động hoặc sân chơi SDK',. Được đề xuất cài đặt cho phép mô phỏng trình duyệt cục bộ và cài đặt phụ thuộc bằng trình quản lý gói bạn đang sử dụng. Tùy chỉnh cho phép bạn thay đổi ứng dụng công khai ID, trình quản lý gói, sở thích mô phỏng và cài đặt cục bộ. Thiết lập xác minh thư mục của bạn trước khi tạo tệp, hiển thị tiến trình cài đặt và in các lệnh khôi phục nếu cài đặt thất bại. Nhấn Ctrl+C để hủy bỏ. Các thư mục không trống hiện có sẽ không bao giờ bị ghi đè.
Sử dụng phiên bản Node LTS được hỗ trợ: phiên bản Node 22.12+ hoặc 24+ được khuyến nghị. Các bản khởi tạo chọn các phiên bản khung tương thích với các liên kết Lia hiện tại, bao gồm Preact 10 và Solid 1.
cd my-lia-app
npm install
npm run devBỏ qua npm install nếu đã cài đặt phụ thuộc. Sử dụng các lệnh phù hợp với trình quản lý gói đã chọn của bạn.
#Kết nối tài khoản Lia của bạn
Sau khi tạo các tệp của bạn, chọn Kết nối & đăng ký để mở Lia Developers trong trình duyệt của bạn. Đăng nhập bằng tài khoản Lia của bạn, so sánh mã hiển thị trên terminal, và phê duyệt yêu cầu. Ứng dụng của bạn được tạo dưới dạng danh sách kiểm thử riêng tư trên bảng điều khiển nhà phát triển của bạn. Chọn Tiếp tục phát triển cục bộ, hoặc bỏ qua --local, để đăng ký sau.
npx @lia-labs/create-app@latest login
npx @lia-labs/create-app@latest whoami
npx @lia-labs/create-app@latest appsĐã có một dự án được tạo? Đăng ký nó từ thư mục dự án:
npx @lia-labs/create-app@latest register --name "My game" --kind gameBạn cũng có thể tạo và đăng ký trong một lệnh:
npm create @lia-labs/app@latest my-game -- --framework react --template demo --register --kind gameViệc đăng ký không yêu cầu lưu trữ. Cho đến khi bạn thêm một HTTPS URL đã triển khai trong bảng điều khiển, mở danh sách sẽ hiển thị một mẫu thiết lập. Sử dụng --url https://your-app.example khi đăng ký nếu dịch vụ lưu trữ đã sẵn sàng. Đăng ký một ứng dụng ID mà bạn đã sở hữu liên kết dự án với danh sách đó mà không cần chỉnh sửa; một ID do người khác sở hữu sẽ bị từ chối. Quản lý thay đổi URL, nghệ thuật, người thử nghiệm và đánh giá trong bảng điều khiển.
Ứng dụng công khai ID được lưu trữ trong lia.config.json và cấu hình khung được tạo ra. Việc đăng ký sẽ thêm thông tin bảng điều khiển và tên máy chủ vào tệp đó. Thông tin đăng nhập tài khoản được lưu riêng biệt trên máy tính của bạn; chúng không bao giờ được ghi vào dự án hoặc mã trình duyệt được tạo ra.
Mã xác nhận trình duyệt hết hạn sau mười phút. Truy cập terminal kéo dài tối đa ba mươi ngày và có thể liệt kê các ứng dụng của bạn, tạo danh sách thử nghiệm riêng và kết nối các bản xem trước cục bộ với các ứng dụng thử nghiệm riêng của bạn. Nó không thể phát hành ứng dụng, đọc khóa máy chủ hoặc thực hiện thanh toán. Sử dụng Các đầu cuối đã kết nối trên bảng điều khiển để thu hồi một thiết bị đầu cuối ngay lập tức, hoặc đăng xuất từ dòng lệnh:
npx @lia-labs/create-app@latest logoutChỉ phê duyệt mã bạn tự bắt đầu. Các yêu cầu truy cập nhà phát triển hiện tại vẫn áp dụng; đăng nhập terminal không vượt qua quy trình mời. Nếu trình duyệt không thể mở tự động, hãy sử dụng login --no-browser và mở liên kết được in ra tự mình. Các yêu cầu bị từ chối hoặc hết hạn có thể được thử lại với login.
#Xem trước ứng dụng cục bộ của bạn bên trong Lia
Từ dự án đã đăng ký của bạn, chạy:
npx @lia-labs/create-app@latest devCLI khởi động máy chủ phát triển khung làm việc của bạn, mở một Cloudflare Tunnel tạm thời và kết nối nó với danh sách thử nghiệm riêng của bạn. Mở lại ứng dụng trong Lia dưới Ứng dụng → Kiểm thử. Các chỉnh sửa tiếp theo sử dụng tính năng live reload của framework của bạn, vì vậy bạn có thể tiếp tục kiểm tra trên điện thoại của mình trong khi thay đổi các tệp cục bộ. Không cần tài khoản Cloudflare hoặc cấu hình DNS.
Nếu Cloudflare Tunnel chưa được cài đặt, Lia tải xuống trình trợ giúp chính thức vào bộ nhớ đệm người dùng và kiểm tra kiểm tra phiên bản trước khi chạy nó. Nó không cài đặt dịch vụ nền. Chọn cổng khác với --port 4201, hoặc một trình quản lý gói với --pm pnpm.
Bảng điều khiển trực tiếp hiển thị máy chủ cục bộ của bạn, HTTPS tunnel và ứng dụng Lia đã kết nối. Nhấn o mở liên kết ứng dụng, d cho bảng điều khiển của nó, hoặc q / Ctrl+C to stop. Existing terminal grants need one new browser approval for local preview access.
Trang URL vĩnh viễn của bạn không thay đổi. Dừng lại sẽ xóa kết nối xem trước, và nếu terminal bị mất, kết nối sẽ hết hạn trong vòng hai phút. Các bản xem trước cục bộ chỉ hoạt động với ứng dụng thử nghiệm riêng và không thể thay thế cho ứng dụng trực tiếp. Triển khai HTTPS lưu trữ vĩnh viễn trước khi gửi để xem xét.
Kết nối tạm thời URL là công khai với bất kỳ ai có được nó, trong khi danh sách Lia vẫn bị giới hạn cho người dùng thử nghiệm hiện tại của bạn. Giữ bí mật sản xuất và dữ liệu khách hàng riêng tư khỏi các bản xem trước trình duyệt cục bộ. Các kết nối nhanh là cơ sở hạ tầng phát triển, không có đảm bảo thời gian hoạt động.
#Cài đặt Terminal
Giao diện thích ứng với các thiết bị nhỏ hơn. Thiết lập NO_COLOR=1 đối với các màu sắc đơn giản, LIA_NO_MOTION=1 để giảm hoạt ảnh tiến trình, hoặc ACCESSIBLE=1 đối với các lời nhắc văn bản tiêu chuẩn. CI và đầu ra được chuyển hướng vẫn giữ nguyên. CLI báo cáo các bước cài đặt thực tế thay vì một phần trăm mô phỏng.
#Chọn một khung công tác
| Khung | Lệnh | Lia tích hợp |
|---|---|---|
| Thường TypeScript | npm create @lia-labs/app@latest my-app -- --framework vanilla | Gọi SDK có kiểu và trạng thái có thể quan sát được. |
| React | npm create @lia-labs/app@latest my-app -- --framework react | useInit, usePlayer, useLanguage, useMainButton. |
| Preact | npm create @lia-labs/app@latest my-app -- --framework preact | Các hook Preact và các liên kết Lia Preact. |
| Vue | npm create @lia-labs/app@latest my-app -- --framework vue | Các thành phần, refs và dọn dẹp component. |
| Svelte | npm create @lia-labs/app@latest my-app -- --framework svelte | Svelte lưu trữ và kiểm soát cấp thành phần. |
| Rắn | npm create @lia-labs/app@latest my-app -- --framework solid | Các bộ truy cập, createInit và createMainButton. |
| Angular | npm create @lia-labs/app@latest my-app -- --framework angular | Một ứng dụng Angular độc lập với các tín hiệu được chèn. |
| Thành phần web | npm create @lia-labs/app@latest my-app -- --framework elements | <lia-app>, <lia-main-button> và SDK đã được định dạng. |
| Cầu cấp thấp | npm create @lia-labs/app@latest my-app -- --framework bridge | Loại được định nghĩa rõ ràng request, send và các ví dụ sự kiện. |
Angular sử dụng bộ xây dựng ứng dụng của nó. Các starter khác sử dụng Vite. Tất cả các starter đều sử dụng TypeScript; các tệp thành phần cụ thể cho framework được bao gồm để bạn có thể tùy chỉnh tích hợp trực tiếp.
#Bắt đầu với một minh họa SDK hoạt động
Thêm --template demo để có danh mục tính năng tương tác trong khung của bạn:
npm create @lia-labs/app@latest my-react-demo -- --framework react --template demo
npm create @lia-labs/app@latest my-vue-demo -- --framework vue --template demo
npm create @lia-labs/app@latest my-angular-demo -- --framework angular --template demoCác demo Khung bao gồm hộp thoại, rung, xác thực, làm mới phiên, mua thử nghiệm, quảng cáo được thưởng/được chèn/banner/native, chia sẻ, lưu trữ, ghi nhận phương tiện, sinh trắc học, quét QR, điều khiển màn hình, lời nhắc và điểm số. Mỗi hành động đều có mã, phản hồi tải và báo cáo kết quả. Các tính năng không được hỗ trợ và việc từ chối quyền được xử lý mà không làm ứng dụng bị treo. Các token phiên và nội dung tệp bị bỏ qua trong báo cáo kết quả.
Bản demo cầu nâng cao tập trung vào các tin nhắn có kiểu thô. Các bản demo khung sử dụng các liên kết tương ứng để có được danh tính người chơi phản ứng, ngôn ngữ và kiểm soát bản địa; chúng chia sẻ các ví dụ tính năng có kiểu, không phải là một iframe bao quanh bản demo JavaScript thô.
Bạn cũng có thể mở Demo SDK bên trong Lia dưới Ứng dụng → Kiểm thử. Mỗi nhà phát triển được đăng ký đều có quyền truy cập mà không cần cấp phép kiểm thử riêng. Hướng dẫn chào mừng và bảng điều khiển của cổng thông tin liên kết đến đó.
#Mô phỏng trình duyệt và kiểm thử thực tế
Cài đặt phát triển địa phương mockLia() chỉ bên ngoài Lia. Thanh toán, quảng cáo và phần thưởng được mô phỏng; không có phiên hoặc thanh toán thực tế nào được tạo. Các bản xây dựng sản xuất loại bỏ mô phỏng phát triển. Angular thay thế mô đun phát triển của nó; các khởi tạo Vite sử dụng cờ phát triển của bản xây dựng.
Tắt mô phỏng với --no-mock. Đối với các dự án Vite, bạn cũng có thể thiết lập VITE_LIA_MOCK=false trong tệp môi trường phát triển cục bộ. Quyền truy cập và phần cứng gốc vẫn cần được kiểm tra bên trong Lia.
- Chạy
npm run buildvà lưu trữ đầu ra trên HTTPS (dist/, hoặcdist/browser/cho Angular). - Đăng ký thông qua CLI hoặc tạo ứng dụng trong cổng phát triển. Thiết lập HTTPS URL đã triển khai trước khi kiểm tra. Một ứng dụng ID trong mã nguồn duy nhất không đăng ký danh sách hoặc xác thực yêu cầu.
- Bạn và tối đa năm người kiểm thử khác tìm thấy nó dưới Ứng dụng → Kiểm thử, bất kể danh mục phát hành của nó.
- Đối với ví dụ mua hàng, tạo một
demo-coinsthử sản phẩm trong cổng. - Đặt ứng dụng kiểm tra bên cạnh Cài đặt → Lưu trữ ứng dụng. Nó sẽ biến mất khỏi danh sách ứng dụng gốc của mọi người và có thể được khôi phục mà không cần xóa cấu hình hoặc dữ liệu kiểm tra.
Việc phát hành công khai yêu cầu được xem xét. Truy cập nhà phát triển mở được lên kế hoạch cho Q1 2027; CLI không thay thế các yêu cầu mời hoặc xuất bản hiện tại.
#Giữ các quyết định quan trọng trên máy chủ của bạn
Không bao giờ tin vào các cuộc gọi lại từ khách hàng, điểm số, giá trị lưu trữ cục bộ hoặc sự kiện đóng quảng cáo để cấp tiền tệ, vật phẩm hoặc phần thưởng. Giữ khóa máy chủ và bí mật webhook ở ngoài mã trình duyệt và tất cả VITE_* biến số.
Bản khởi tạo không giả mạo xác minh máy chủ hoặc bao gồm một điểm cuối giao hàng không an toàn. Các giao dịch mua hàng và nộp điểm số trong bản demo chỉ được giới hạn ở chế độ kiểm tra. Thêm một backend mà xác minh phiên làm việc, kiểm tra từng khoản phí, ứng dụng, người chơi, sản phẩm, chế độ và trạng thái, thực hiện một lần và xác nhận việc giao hàng. Giữ riêng biệt kế toán thử nghiệm và sản xuất.
#Quản lý gói và tự động hóa
pnpm create @lia-labs/app my-app --framework vue --template demo
yarn create @lia-labs/app my-app --framework svelte
bun create @lia-labs/app my-app --framework solidĐối với các tập lệnh hoặc CI:
npm create @lia-labs/app@latest my-app -- --framework react --template starter --app-id my-app --yes --no-install --localCài đặt không tương tác vẫn giữ cục bộ trừ khi bạn truyền --register; việc đăng ký mà không có thông báo yêu cầu đã có đăng nhập terminal. Sử dụng --install để cài đặt tự động. --help liệt kê các tùy chọn. Nếu cài đặt thất bại, các tệp được tạo vẫn có sẵn và CLI in ra lệnh để thử lại.
#Thêm backend bảo mật
Chạy npx @lia-labs/create-app@latest backend cho một dự án máy chủ riêng biệt trong TypeScript/JavaScript, Python, PHP hoặc Go. Chọn Node/Express, FastAPI/Django, PHP HTTP hoặc Go HTTP. Các mẫu này bao gồm phiên người chơi đã xác minh, webhook được ký, kiểm tra thanh toán và kho hàng bền vững với hóa đơn duy nhất. Giữ bí mật máy chủ khỏi phía giao diện người dùng của bạn. Xem gói backend và hướng dẫn tích hợp framework.
Được dịch tự động. Tiếng Anh là nguồn tin cậy. Đọc bằng tiếng Anh