"Processing Symbol Files" là thông báo xuất hiện trên Xcode khi build project cho thiết bị thật. Ở background, Xcode đang tải về và xử lý symbol files (file ký hiệu debug) cho thiết bị cụ thể và kiến trúc processor (arm64) mà build sẽ cài đặt.
Symbol Files là gì?
- Chứa debug symbols (ký hiệu gỡ lỗi) cho iOS version và processor cụ thể.
- Dùng để symbolicate crash logs – chuyển địa chỉ bộ nhớ thô trong crash report thành tên hàm, dòng code, file nguồn có thể đọc được.
- Khi xong, Xcode tạo thư mục symbol mới tại:
~/Library/Developer/Xcode/iOS DeviceSupport/[iOS Version]/
Tại sao đôi khi bị treo (stuck) ở bước này?
- Cáp USB kém chất lượng hoặc kết nối lỏng.
- Quá nhiều crash log cũ tích tụ trên thiết bị.
- Mạng chậm (khi tải symbol files từ Apple server).
- Xcode/DeviceSupport version mismatch.
Cách khắc phục
- Thay cáp USB chất lượng tốt (cáp gốc Apple hoặc MFi certified).
- Xóa crash logs cũ: Xcode > Window > Devices and Simulators > chọn device > View Device Logs > Delete all.
- Xóa thư mục DeviceSupport cũ:
~/Library/Developer/Xcode/iOS DeviceSupport/(xóa thư mục iOS version không dùng). - Restart Xcode và thiết bị.
- Đảm bảo Mac có kết nối internet ổn định (để tải symbol từ Apple).
Mẹo: Có thể tắt "Automatically sync debug symbols" trong Xcode Preferences > Locations để tránh tự động xử lý, nhưng không khuyến khích.