VIETTYPE INDEPENDENT BETA — HƯỚNG DẪN CÀI ĐẶT
Phiên bản 0.12.10 • macOS 13 trở lên • Mac chip Apple Silicon (M1 trở lên)
Bản beta dành cho nhóm dùng thử; không chạy trên Mac Intel hoặc Windows.

1. CÀI VÀ MỞ APP
• Giải nén file ZIP. Kéo VietType Independent Beta.app vào thư mục Applications (Ứng dụng).
• Nếu đang dùng bản cũ: xuất bản sao lưu trong app, thoát app rồi thay bản mới.
• Mở app trong Applications. App nằm trên thanh menu với biểu tượng Vi/En, có thể không có biểu tượng ở Dock.

2. NẾU MACOS CHẶN MỞ
Bản beta chưa được Apple notarize. Không cần tắt Gatekeeper toàn máy.
• Mở app một lần để macOS hiển thị thông báo, rồi đóng thông báo.
• Vào System Settings (Cài đặt hệ thống) → Privacy & Security (Quyền riêng tư & Bảo mật).
• Tìm thông báo về VietType Independent Beta, chọn Open Anyway (Vẫn mở).
• Xác thực bằng Touch ID hoặc mật khẩu của chính bạn nếu được yêu cầu, rồi chọn Open (Mở).
macOS ghi nhớ ngoại lệ cho app để những lần sau mở bình thường.
Chỉ xác nhận cho bản tải từ nguồn bạn tin cậy. Nếu báo app bị hỏng hoặc chứa phần mềm độc hại, không áp dụng cách này; tải lại bản đúng hoặc báo người cung cấp. Máy công ty có thể bị quản trị viên giới hạn quyền mở app.
Hướng dẫn chính thức của Apple: https://support.apple.com/en-us/102445

3. CẤP QUYỀN ĐỂ GÕ
• Vào System Settings → Privacy & Security → Accessibility (Trợ năng).
• Thêm VietType Independent Beta từ Applications nếu chưa có, rồi bật quyền.
• Thoát và mở lại app nếu chưa nhận phím.
• Chọn nguồn nhập ABC của macOS. Thoát OpenKey, EVKey hoặc bộ gõ tiếng Việt khác trước khi dùng VietType; chỉ chạy một bộ gõ cùng lúc.
• Nhấn Option + Command + 0 để chuyển Vi/En. Đổi Telex/VNI trong Cài đặt của VietType.
• Thử gõ trong TextEdit trước: với Telex, gõ ddang rồi Space để kiểm tra chữ đang.

4. MẪU TRẢ LỜI, GÕ TẮT VÀ QR
• Menu Vi/En → Cài đặt… → Mẫu trả lời để tạo, sửa mẫu.
• Gõ mã như ;baogia rồi Space để dán. Hoặc Option + Command + K để tìm và dán mẫu.
• Mẫu có {ten_khach} hoặc {ma_don} sẽ mở ô điền thông tin trước khi dán.
• Trang QR chuyển khoản: nhập tài khoản của bạn. Có thể chọn ngẫu nhiên nội dung chuyển khoản, đặt nội dung mặc định hoặc để trống.
• QR mới cần Internet: thông tin tài khoản, tên chủ tài khoản, số tiền và nội dung chuyển khoản được gửi tới VietQR.io qua HTTPS để tạo ảnh. Kiểm tra thông tin bằng app ngân hàng trước khi sử dụng.
• Chữ đã lưu được dán kèm ảnh QR; nội dung chuyển khoản không tự chèn thêm thành chữ trong chat. Gói cài không kèm dữ liệu chat hoặc tài khoản cá nhân.
• App không tự gửi tin nhắn. Kiểm tra nội dung trước khi gửi; cách dán ảnh tùy ứng dụng nhận.

5. LƯU VÀ SAO LƯU
• Mẫu được tự lưu trên máy. Vào Cài đặt → Sao lưu & khôi phục để xuất file JSON hoặc nhập lại.
• Dữ liệu mẫu: ~/Library/Application Support/VietTypeIndependentBeta/
• Sao lưu có thể chứa nội dung mẫu, ảnh và thông tin QR; giữ file ở nơi riêng tư.
• Muốn khởi động cùng máy: bật Khởi động cùng macOS trong Cài đặt sau khi đã đặt app vào Applications. Phê duyệt trong System Settings → General → Login Items nếu macOS yêu cầu.

6. CHUYỂN TỪ VIETTYPE BETA SANG BẢN LÕI ĐỘC LẬP
• Trong VietType Beta cũ: Cài đặt → Sao lưu & khôi phục → Xuất file sao lưu…
• Tắt Khởi động cùng macOS ở bản cũ, rồi thoát bản cũ.
• Mở VietType Independent Beta và cấp quyền Trợ năng riêng cho bản này.
• Vào Cài đặt → Sao lưu & khôi phục, chọn file đã xuất để nhập các mẫu và cấu hình QR.
• Bản độc lập dùng thư mục dữ liệu riêng, không tự đọc hoặc ghi đè dữ liệu bản cũ. Các lựa chọn bộ gõ và quyền hệ thống cần kiểm tra lại.
• Chỉ bật Khởi động cùng macOS ở bản bạn chọn dùng. Không chạy hai bộ gõ cùng lúc.

7. KHI GẶP LỖI
• Không gõ được: kiểm tra trạng thái Vi, quyền Trợ năng, nguồn nhập ABC và bộ gõ khác đang chạy.
• Sau cập nhật nếu mất quyền: kiểm tra lại mục Accessibility, tắt/bật quyền rồi mở lại app.
• Ghi lại phiên bản macOS, ứng dụng đang nhập, chuỗi phím đã gõ và kết quả sai để báo lỗi. Tránh gửi mật khẩu hoặc nội dung riêng tư.
• Đây là bản beta: chưa xác nhận tương thích đầy đủ với Google Docs, Notion và mọi ứng dụng chat; gợi ý sửa lỗi cũng còn giới hạn.
• Để gỡ: thoát app, bỏ app khỏi Applications. Dữ liệu mẫu vẫn được giữ riêng để tránh mất dữ liệu.

THÔNG TIN BẢN ĐÓNG GÓI
Đây là VietType Independent Beta, dùng lõi VietInputEngine viết riêng, không đóng gói TelexCore.
Lõi độc lập vẫn đang thử nghiệm; cần kiểm tra bằng bàn phím thật trong các ứng dụng bạn thường dùng trước khi dùng làm bộ gõ chính.
Chữ ký hiện tại là Apple Development, không phải Developer ID và chưa notarize.