Chuyển đến nội dung chính

​
Cài đặt

Hướng dẫn này bao gồm hướng dẫn cài đặt chi tiết, yêu cầu hệ thống và khắc phục các vấn đề cài đặt phổ biến.

​
Yêu cầu Hệ thống

​
Yêu cầu Tối thiểu

Yêu cầuThông số kỹ thuật
Phiên bản macOSmacOS 13.5 (Ventura) hoặc mới hơn
Bộ xử lýApple Silicon (M1/M2/M3/M4/M5) hoặc Intel x86_64
Bộ nhớTối thiểu 4 GB RAM
Dung lượng~50 MB dung lượng trống

​
Khuyến nghị

  • macOS: Phiên bản mới nhất để có hiệu suất tốt nhất
  • Bộ nhớ: 8 GB RAM hoặc nhiều hơn cho cơ sở dữ liệu lớn
  • Dung lượng: SSD để có hiệu suất tối ưu
TablePro được xây dựng bằng các framework gốc của Apple và không yêu cầu bất kỳ môi trường runtime bổ sung nào như Java hay .NET.

​
Tải xuống

​
Từ GitHub Releases

  1. Truy cập trang TablePro Releases
  2. Tìm bản phát hành mới nhất
  3. Tải xuống DMG phù hợp cho Mac của bạn:
Kiến trúcFileDành cho Mac với
Apple SiliconTablePro-arm64.dmgChip M1, M2, M3, M4, M5
IntelTablePro-x86_64.dmgBộ xử lý Intel

​
Kiểm tra Kiến trúc Mac của bạn

  1. Nhấp vào menu Apple () trên thanh menu
  2. Chọn About This Mac
  3. Tìm:
    • Chip: Apple M1/M2/M3/M4/M5 = Apple Silicon
    • Processor: Intel = x86_64

​
Các bước Cài đặt

​
Cài đặt Tiêu chuẩn

  1. Mở file DMG
    • Nhấp đúp vào file .dmg đã tải xuống
    • Một cửa sổ Finder mới sẽ xuất hiện
  2. Kéo vào Applications
    • Kéo biểu tượng TablePro vào shortcut thư mục Applications
    • Đợi quá trình sao chép hoàn tất
Kéo vào Applications
  1. Đẩy DMG ra
    • Nhấp chuột phải vào DMG đã mount trong sidebar Finder
    • Chọn Eject
  2. Khởi chạy TablePro
    • Mở Finder > Applications
    • Nhấp đúp vào TablePro

​
Bảo mật Khởi chạy Lần đầu

Vì TablePro không được ký với chứng chỉ Apple Developer, macOS Gatekeeper có thể ngăn không cho nó mở khi khởi chạy lần đầu.
Đây là hành vi mong đợi đối với các ứng dụng không được ký. TablePro an toàn để sử dụng - mã nguồn hoàn toàn mở và có thể kiểm tra.

​
Để mở ứng dụng không được ký:

1

Tìm ứng dụng

Mở Finder và điều hướng đến Applications
2

Nhấp chuột phải để mở

Nhấp chuột phải (hoặc Control-click) vào TablePro
3

Chọn Open

Chọn Open từ menu ngữ cảnh
4

Xác nhận

Trong hộp thoại xuất hiện, nhấp Open
Bạn chỉ cần làm điều này một lần. Các lần khởi chạy tiếp theo sẽ hoạt động bình thường.

​
Thay thế: System Settings

Nếu phương pháp nhấp chuột phải không hoạt động:
  1. Mở System Settings > Privacy & Security
  2. Cuộn xuống phần Security
  3. Bạn sẽ thấy thông báo về TablePro bị chặn
  4. Nhấp Open Anyway
  5. Nhập mật khẩu nếu được yêu cầu

​
Cập nhật TablePro

​
Cập nhật Tự động

TablePro tích hợp tính năng cập nhật tự động được hỗ trợ bởi Sparkle. Ứng dụng định kỳ kiểm tra phiên bản mới trong nền và thông báo cho bạn khi có bản cập nhật.

​
Kiểm tra Cập nhật Thủ công

Để kiểm tra cập nhật thủ công:
  1. Mở menu TablePro trên thanh menu
  2. Nhấp Check for Updates…

​
Cài đặt Cập nhật

Bạn có thể cấu hình hành vi cập nhật trong Settings > General > Software Update:
  • Bật hoặc tắt kiểm tra cập nhật tự động
  • Chọn tần suất kiểm tra cập nhật
Các kết nối và cài đặt của bạn được lưu trữ riêng biệt với ứng dụng và sẽ được giữ nguyên khi cập nhật.

​
Vị trí Lưu trữ Dữ liệu

TablePro lưu trữ dữ liệu ở các vị trí sau:
Dữ liệuVị tríLoại lưu trữ
Kết nối~/Library/Preferences/com.TablePro.plistUserDefaults
Cài đặt~/Library/Preferences/com.TablePro.plistUserDefaults
Mật khẩumacOS Keychain (lưu trữ an toàn)Keychain
Lịch sử truy vấn~/Library/Application Support/TablePro/query_history.dbSQLite

​
Gỡ cài đặt

​
Xóa Ứng dụng

  1. Thoát TablePro nếu đang chạy
  2. Mở Finder > Applications
  3. Kéo TablePro vào Thùng rác

​
Xóa Dữ liệu Ứng dụng (Tùy chọn)

Để xóa hoàn toàn tất cả dữ liệu TablePro: 
# Xóa dữ liệu hỗ trợ ứng dụng
rm -rf ~/Library/Application\ Support/TablePro

# Xóa preferences
rm ~/Library/Preferences/com.TablePro.plist

# Xóa các mục Keychain (thông qua ứng dụng Keychain Access)
# Tìm kiếm "TablePro" và xóa các mục liên quan
Xóa dữ liệu ứng dụng sẽ xóa tất cả các kết nối đã lưu và lịch sử truy vấn của bạn. Đảm bảo xuất bất kỳ dữ liệu quan trọng nào trước.

​
Khắc phục Sự cố

​
”TablePro is damaged and can’t be opened”

Lỗi này có thể xảy ra nếu các thuộc tính quarantine của macOS không được xóa đúng cách: 
xattr -cr /Applications/TablePro.app
Sau đó thử mở lại ứng dụng.

​
”TablePro can’t be opened because it is from an unidentified developer”

Làm theo hướng dẫn Bảo mật Khởi chạy Lần đầu ở trên.

​
Ứng dụng crash khi khởi chạy

  1. Kiểm tra xem bạn đã tải xuống phiên bản kiến trúc đúng chưa
  2. Đảm bảo bạn đang chạy macOS 13.5 hoặc mới hơn
  3. Thử xóa và cài đặt lại ứng dụng
  4. Kiểm tra Console.app để xem crash logs

​
Vấn đề kết nối sau khi cài đặt

Nếu TablePro mở nhưng không thể kết nối với cơ sở dữ liệu:
  1. Xác minh máy chủ cơ sở dữ liệu của bạn đang chạy
  2. Kiểm tra cài đặt tường lửa (System Settings > Network > Firewall)
  3. Đảm bảo máy chủ cơ sở dữ liệu cho phép kết nối từ localhost

​
Build từ Source

Đối với các nhà phát triển muốn build TablePro từ source:
  1. Clone repository:
git clone https://github.com/datlechin/tablepro.git
cd tablepro
  1. Mở project Xcode:
open TablePro.xcodeproj
  1. Build và chạy:
    • Chọn scheme TablePro
    • Nhấn Cmd+R để build và chạy
Xem hướng dẫn Development Setup để biết hướng dẫn chi tiết.

​
Các bước tiếp theo

Bắt đầu Nhanh

Kết nối với cơ sở dữ liệu đầu tiên của bạn

Kết nối Cơ sở dữ liệu

Tìm hiểu về quản lý kết nối