
DINHDANH Creator · Bài K11 · Kỹ thuật
theo mục đích - đừng hứa APK khi chỉ cần PDF
Góc nhìn kỹ thuật cho modal Xuất nội dung: chọn đúng nhãn Chụp ảnh, PDF, Word, .afi - và hiểu giới hạn APK BETA trước khi cam kết với khách.
Mục tiêu bài học: Map nhu cầu → định dạng Export đúng; biết Tên App lấy từ Hồ sơ dự án; tránh lỗi preview khi xuất.
Thời lượng đọc: khoảng 12 phút
Điều kiện trước: Preview ổn định (C01); chi tiết đầy đủ ở E04.
Bài trước → sau: K10 → K11 → K12
Nhãn UI: Export · Xuất nội dung · Chụp ảnh · Vùng hiển thị · Toàn trang · PDF 1 Trang · PDF Đầy đủ · Xuất Word (.doc) · Dự án DINHDANH (.afi) · Tên App · Hồ sơ dự án (README.md)
1. Sơ đồ chọn định dạng
2. Thuật ngữ
| Thuật ngữ | Nghĩa |
|---|---|
| Xuất nội dung | Tiêu đề modal mở từ nút Export - hai nhóm Chụp ảnh và Gói dự án |
| Vùng hiển thị / Toàn trang | Chụp phần viewport hoặc cuộn hết chiều dài trang |
| Dự án DINHDANH (.afi) | Gói nén toàn bộ mã nguồn + tài nguyên - coi như backup ngoài Versions |
| Tên App | Trường khi đóng gói .afi/APK - lấy từ Hồ sơ dự án (README.md) |
| APK BETA | Build Android thử nghiệm - có thể thất bại hoặc bị chặn trên gói miễn phí |
3. Các bước xuất file
- Ổn định preview - chọn tab Thay đổi hoặc Hiện tại tùy mục đích xuất.
- Nhấn Export → modal Xuất nội dung (phụ đề: Chọn định dạng xuất).
- Chụp ảnh: chọn Vùng hiển thị hoặc Toàn trang - theo dõi trạng thái Đang chuẩn bị… → Hoàn thành!
- Chọn PDF 1 Trang, PDF Đầy đủ, hoặc Xuất Word (.doc) khi cần in/email/sửa ngoài.
- Dự án DINHDANH (.afi): kiểm tra Tên App khớp Hồ sơ dự án trước khi tải - file chứa source nhạy cảm.
- APK BETA: chỉ thử sau khi đọc giới hạn E04 - không hứa khách khi chưa build thành công trên máy thật.
4. Giải thích từng nhóm Export
Chụp ảnh (Vùng hiển thị / Toàn trang): Nhanh, nhẹ - gửi stakeholder xem layout. Toàn trang có thể lỗi nếu trang quá dài hoặc html2canvas chưa load.
PDF / Word: PDF 1 Trang cho email báo giá; PDF Đầy đủ cho tài liệu nhiều section. Word (.doc) để biên tập viên sửa chữ ngoài Creator.
.afi: Backup định kỳ + chuyển dự án - chỉ gửi người được ủy quyền (có thể chứa backend/secrets path).
APK BETA: Tác vụ nặng - gói miễn phí có thể báo “Tác vụ nặng không khả dụng”; build phức tạp có thể “Build thất bại”. Chi tiết: E04.
5. So sánh với công cụ khác
- Figma export PNG/PDF: mạnh thiết kế tĩnh - DINHDANH xuất trang chạy thật + .afi source.
- Webflow Export code: ZIP HTML tĩnh - .afi giữ cấu trúc DINHDANH + backend folder.
- Bubble mobile wrap: cùng mức “beta/giới hạn” khi hứa app store từ no-code.
6. Giới hạn kỹ thuật
Làm được
- Ảnh/PDF/Word từ preview đang mở
- .afi backup toàn project
- APK thử trên gói hỗ trợ tác vụ nặng
Hạn chế
- Export khi preview chưa load → “Không tìm thấy preview”
- APK BETA không đảm bảo store-ready
- Gói miễn phí có thể chặn build nặng
7. Bảo mật
File Dự án DINHDANH (.afi) có thể chứa cấu trúc backend và đường dẫn secrets - không gửi qua kênh công khai. APK build từ project có API tích hợp thật - test trên thiết bị riêng trước khi phát hành.
PDF/Word/ảnh chụp có thể lộ nội dung nháp - kiểm tra tab Thay đổi vs Hiện tại trước khi Export cho khách ngoài tổ chức.
8. Vấn đề thường gặp
| Tình huống | Xử lý |
|---|---|
| “Không tìm thấy preview” | Đợi iframe load; xử lý overlay custom domain (K09) rồi export lại |
| Toàn trang lỗi chụp | Thử Vùng hiển thị; refresh nếu thiếu html2canvas |
| Tên App / logo sai trong .afi | Cập nhật Hồ sơ dự án (README.md) trước khi xuất |
| Build APK thất bại | Kiểm tra gói tài khoản; đơn giản hoá app; xem E04 |
9. Lời khuyên
- Xuất .afi định kỳ song song Clone/Versions - hai lớp backup.
- Gửi khách: Chụp ảnh Vùng hiển thị thay vì APK khi chỉ cần duyệt giao diện.
- Điền Hồ sơ dự án (B06) sớm - Tên App đúng ngay lần export đầu.
10. Checklist tự kiểm
- Bạn chọn đúng định dạng theo mục đích (ảnh / PDF / .afi / APK)?
- Bạn biết Tên App lấy từ Hồ sơ dự án (README.md)?
- Bạn đã đọc giới hạn APK BETA ở E04 trước khi hứa khách?
Bài tiếp theo
K12 - MCP path trên Windows
JSON MCP gãy vì một dấu \ - Cách A dấu / vs Cách B backslash thoát; tham chiếu H02, T12, X09.
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Bộ hướng dẫn người dùng · K11 · Tham chiếu E04