2.0 KiB
2.0 KiB
| summary | read_when | |
|---|---|---|
| Hướng dẫn thiết lập dành cho nhà phát triển ứng dụng Moltbot trên macOS |
|
Thiết lập môi trường phát triển trên macOS
Hướng dẫn này bao gồm các bước cần thiết để xây dựng và chạy ứng dụng Moltbot trên macOS từ mã nguồn.
Yêu cầu chuẩn bị
Trước khi bắt đầu, hãy đảm bảo bạn đã cài đặt:
- Xcode 16.2+: Bắt buộc để lập trình Swift.
- Node.js 22+ & pnpm: Dùng cho Gateway, CLI và các kịch bản đóng gói.
1. Cài đặt phụ thuộc
Chạy lệnh sau tại thư mục gốc của dự án:
pnpm install
2. Xây dựng và Đóng gói ứng dụng
Để biên dịch ứng dụng macOS và đóng gói vào thư mục dist/Moltbot.app, hãy chạy:
./scripts/package-mac-app.sh
Nếu bạn không có chứng chỉ Apple Developer ID, kịch bản sẽ tự động sử dụng chữ ký ad-hoc (-).
3. Cài đặt CLI
Ứng dụng macOS cần có CLI moltbot được cài đặt toàn cục để quản lý các tác vụ ngầm.
- Mở ứng dụng Moltbot.
- Vào tab General trong phần cài đặt.
- Nhấn "Install CLI".
Xử lý sự cố
- Lỗi biên dịch: Hãy kiểm tra phiên bản Xcode và Swift của bạn bằng lệnh
xcodebuild -version. - Ứng dụng bị sập khi cấp quyền: Nếu ứng dụng văng khi bạn nhấn cho phép dùng Micro hoặc Nhận dạng giọng nói, hãy thử đặt lại quyền hạn TCC bằng lệnh:
tccutil reset All bot.molt.mac.debug. - Gateway bị treo ở trạng thái "Starting...": Có thể một tiến trình cũ đang chiếm giữ cổng. Hãy kiểm tra bằng lệnh
lsof -nP -iTCP:18789 -sTCP:LISTEN.
Tài liệu liên quan: Đánh giá sức khỏe, Cấu hình hệ thống.