​

Thiết lập Phát triển

​

Yêu cầu

​

Phần mềm bắt buộc

​

Công cụ tùy chọn

​

Bắt đầu

​

Bước 1: Clone Repository

git clone https://github.com/datlechin/tablepro.git
cd tablepro

​

Bước 2: Cài đặt Development Tools

# Sử dụng Homebrew
brew install swiftlint swiftformat

​

Bước 3: Mở trong Xcode

open TablePro.xcodeproj

​

Bước 4: Build và Run

1. Chọn scheme TablePro trong Xcode
2. Chọn My Mac làm destination
3. Nhấn Cmd+R để build và chạy

​

Cấu trúc dự án

​

Build

​

Build Phát Triển

# Build cho kiến trúc hiện tại (Debug)
xcodebuild -project TablePro.xcodeproj -scheme TablePro -configuration Debug build -skipPackagePluginValidation

# Hoặc sử dụng Xcode: Cmd+B

​

Build Release

# Build cho Apple Silicon
scripts/build-release.sh arm64

# Build cho Intel
scripts/build-release.sh x86_64

# Build cho cả hai kiến trúc
scripts/build-release.sh both

​

Chạy Tests

# Chạy tất cả tests
xcodebuild -project TablePro.xcodeproj -scheme TablePro test -skipPackagePluginValidation

# Chạy test class cụ thể
xcodebuild -project TablePro.xcodeproj -scheme TablePro test -skipPackagePluginValidation \
    -only-testing:TableProTests/TestClassName

# Chạy test method cụ thể
xcodebuild -project TablePro.xcodeproj -scheme TablePro test -skipPackagePluginValidation \
    -only-testing:TableProTests/TestClassName/testMethodName

​

Chất lượng Code

​

SwiftLint

# Kiểm tra các vấn đề
swiftlint lint

# Tự động sửa các vấn đề có thể sửa
swiftlint --fix

​

SwiftFormat

# Format tất cả code
swiftformat .

# Kiểm tra formatting mà không áp dụng
swiftformat --lint .

​

Tệp cấu hình

​

.swiftlint.yml

• Giới hạn độ dài dòng
• Giới hạn độ phức tạp function
• Các rules bị vô hiệu hóa
• Các rules tùy chỉnh

​

.swiftformat

• Kiểu indentation
• Vị trí brace
• Thứ tự import
• Các rules formatting khác

​

Workflow phát triển

​

Thực hiện thay đổi

1. Tạo feature branch:
   Sao chép

   git checkout -b feature/my-feature
   
2. Thực hiện thay đổi của bạn
3. Chạy linting:
   Sao chép

   swiftlint lint
   swiftformat --lint .
   
4. Chạy tests:
   Sao chép

   xcodebuild -project TablePro.xcodeproj -scheme TablePro test -skipPackagePluginValidation
   
5. Commit thay đổi của bạn:
   Sao chép

   git add .
   git commit -m "Add my feature"
   
6. Push và tạo pull request:
   Sao chép

   git push origin feature/my-feature
   

​

Debugging

1. Đặt breakpoints bằng cách click số dòng
2. Sử dụng po trong debug console để in objects
3. Sử dụng Variables View để kiểm tra state
4. Sử dụng Console.app cho system logs

​

Logging

import os

private static let logger = Logger(subsystem: "com.TablePro", category: "ComponentName")

// Sử dụng
logger.debug("Connection established")
logger.info("Query executed in \(duration)s")
logger.error("Failed to connect: \(error.localizedDescription)")

​

Các tác vụ thông dụng

​

Thêm một View mới

1. Tạo SwiftUI view trong subfolder Views/ phù hợp
2. Tuân theo quy ước đặt tên hiện tại (FeatureNameView.swift)
3. Sử dụng @Observable hoặc @StateObject cho quản lý state
4. Thêm vào navigation/routing nếu cần

​

Thêm tính năng Database

1. Triển khai trong driver phù hợp (MySQLDriver.swift, etc.)
2. Thêm vào protocol DatabaseDriver nếu là generic
3. Thêm UI trong các view components liên quan
4. Thêm tests

​

Sửa đổi Settings

1. Thêm vào struct settings phù hợp trong AppSettings.swift
2. Cập nhật SettingsView để hiển thị setting
3. Sử dụng setting trong toàn bộ app qua @AppStorage hoặc settings manager

​

Khắc Phục Sự Cố

​

Lỗi Build

1. Clean build folder: Cmd+Shift+K
2. Xóa derived data:
   Sao chép

   rm -rf ~/Library/Developer/Xcode/DerivedData
   
3. Đóng và mở lại Xcode
4. Kiểm tra cập nhật Xcode

​

Lỗi SwiftLint

1. Đọc kỹ error message
2. Kiểm tra .swiftlint.yml cho cấu hình rule
3. Sửa vấn đề hoặc vô hiệu hóa rule nếu phù hợp
4. Chạy swiftlint --fix cho các vấn đề có thể tự động sửa

​

Thư viện bị thiếu

1. Kiểm tra thư mục Libs/
2. Đảm bảo libmariadb_universal.a tồn tại
3. Chạy scripts/build-release.sh để chuẩn bị thư viện

​

Bước tiếp theo