Sử dụng bản xuất
Sau khi xuất và tải tệp xuống, đây là cách dùng từng định dạng.
Gói Kohana (.koha)
Xem Chia sẻ gói.
Bản xuất HTML (.html)
Giải nén tệp .zip; bên trong có index.html và các tệp hỗ trợ tạo thành một website nhỏ, không cần mã máy chủ.
- Để thử cục bộ, đừng chỉ nhấp đúp vào
index.html— trình duyệt sẽ chặn các yêu cầu tải tài nguyên mà nó cần khi tệp được mở trực tiếp từ ổ đĩa, nên truyện sẽ không tải được. Thay vào đó, chạy một máy chủ cục bộ đơn giản từ thư mục đã giải nén:python -m http.server(rồi mởhttp://localhost:8000), hoặc dùng tiện ích mở rộng trình soạn thảo như Live Server của VS Code. - Để lưu trữ cho người khác, tải toàn bộ thư mục đã giải nén (không chỉ
index.html) lên bất kỳ dịch vụ lưu trữ web tĩnh nào, giữ nguyên cấu trúc: GitHub Pages, Netlify (hoặc Netlify Drop để triển khai nhanh bằng kéo-thả, không cần tài khoản), Cloudflare Pages, Neocities, hoặc máy chủ riêng. Chia sẻ địa chỉ nơiindex.htmlđược đặt. - Để chia sẻ trên trang web trò chơi, tải tệp
.ziplên nguyên trạng: itch.io (chọn "This file will be played in the browser" và đặtindex.htmllàm điểm vào) và Game Jolt đều lưu trữ trò chơi HTML5 trực tiếp, Newgrounds cũng vậy. - Để nhúng vào một trang, sau khi đã lưu trữ ở đâu đó, dùng
<iframe src="https://mayquy.vidu.com/duong-dan/" width="960" height="540"></iframe>. Cách này khác với Chia sẻ và nhúng của Web Player — mục đó nhúng một truyện do Kohana lưu trữ và kiểm duyệt theo Quy tắc cộng đồng; bản xuất HTML tự lưu trữ hoàn toàn là trang web và trách nhiệm của riêng bạn.
Gói Android (.apk)
.apk cài trực tiếp vào điện thoại hoặc máy tính bảng Android, không cần Play Store. Đây là bản dựng phát hành được ký thực sự (Kohana tạo và giữ một khóa ký riêng cho tên gói của bạn, không phải chứng chỉ gỡ lỗi) — nên cảnh báo duy nhất bạn thấy là về việc cài đặt ngoài cửa hàng, không phải vì có gì đáng ngờ.
Gửi tệp đến thiết bị, mở nó, cho phép cài ứng dụng từ nguồn đó khi Android yêu cầu (Cài đặt > ứng dụng có thể cài ứng dụng không xác định, cách gọi tùy phiên bản), rồi cài và mở như ứng dụng khác. Cảnh báo là bình thường với mọi ứng dụng ngoài Play Store.
Để chia sẻ rộng hơn một liên kết trực tiếp, itch.io và Game Jolt đều chấp nhận .apk làm bản dựng Android có thể tải xuống trên trang trò chơi của bạn.
Android App Bundle (.aab)
Tệp .aab không cài trực tiếp; nó dành cho Google Play. Được ký bằng cùng khóa thật với .apk của bạn.
Tạo tài khoản Play Console, tạo ứng dụng, vào Release > Production (hoặc Testing), tạo bản phát hành và tải .aab lên — lần đầu, Play Console có thể yêu cầu thiết lập Play App Signing, và có thể hỏi dấu vân tay chứng chỉ ký của bạn như một phần của việc đó. Sau đó hoàn tất thông tin cửa hàng, xếp hạng nội dung, chính sách riêng tư và gửi Google xét duyệt.
Nếu tài khoản Play Console của bạn còn mới (tạo sau ngày 13 tháng 11 năm 2023), Google yêu cầu thử nghiệm kín với ít nhất 12 người thử nghiệm đã tham gia trong 14 ngày liên tục trước khi mở khóa Production — điều này áp dụng cho mọi tài khoản cá nhân mới, không riêng gì Kohana. Tài khoản tạo trước ngày đó, và tài khoản tổ chức, được miễn. Đây hoàn toàn là quy trình của Google và có thể thay đổi — xem Trung tâm trợ giúp Google Play Console để biết yêu cầu và các bước chính xác hiện tại.
Tệp thực thi Windows (.exe)
Một tệp .exe độc lập duy nhất — không cần gì khác đi kèm. Gửi tệp tới PC Windows và nhấp đúp để chạy, không cần trình cài đặt. Tệp này cần runtime WebView2, vốn đã có sẵn trên Windows 11 và hầu hết Windows 10 đã cập nhật; nếu thiếu, Windows sẽ nhắc cài đặt (bản tải miễn phí, một lần, từ Microsoft). Vì bản thân .exe chưa ký mã, SmartScreen có thể cảnh báo lần đầu; chọn More info > Run anyway. Đây là điều bình thường với mọi ứng dụng nhỏ, chưa ký.
Nếu gửi cho nhiều hơn vài người, hãy nén .exe thành .zip trước (gộp thành một tệp đính kèm và tránh một số cảnh báo tải xuống nhắm vào liên kết .exe trần). itch.io và Game Jolt đều chấp nhận bản dựng Windows đã nén làm trò chơi có thể tải xuống.
Tệp lưu và Steam Cloud
Trình phát Windows lưu tất cả vị trí lưu tại:
%APPDATA%/<mã định danh gói xuất>/save_states.json
Mã định danh gói là giá trị bạn nhập khi yêu cầu xuất. Đừng thay đổi nó giữa các phiên bản để bản cập nhật tiếp tục dùng cùng dữ liệu lưu. Kohana xác thực và ghi tệp theo từng bước an toàn, giữ một bản sao cục bộ hợp lệ gần nhất và có thể tự động khôi phục dữ liệu lưu WebView cũ.
Để đồng bộ dữ liệu lưu bằng Steam Auto-Cloud, hãy cấu hình trò chơi trong Steamworks như sau:
| Cài đặt | Giá trị |
|---|---|
| Root | WinAppDataRoaming |
| Subdirectory | Mã định danh chính xác của gói xuất Kohana |
| Pattern | save_states.json |
| OS | Windows |
| Recursive | Tắt |
Đặt hạn mức dung lượng và số tệp phù hợp cho mỗi người dùng, phát hành cấu hình Steamworks rồi kiểm tra trên một nhánh riêng tư bằng hai máy tính Windows. Hãy đóng trò chơi trước khi chờ Steam tải tệp lên. Steam Cloud là tùy chọn và người chơi có thể tắt; dữ liệu lưu cục bộ vẫn là bản chính khi trò chơi đang chạy. Không thêm save_states.backup.json vào mẫu Cloud vì đó là dữ liệu khôi phục cục bộ.