Native bridge iOS: Objective-C/C++, luồng chính và vòng đời ứng dụng
Objective-C++ (.mm) để trộn C++ và Objective-C, chuyển đổi chuỗi/ kiểu, ARC bên cạnh bộ nhớ C++, gọi UIKit trên luồng chính, gọi từ game xuống iOS và ngược lại ở cả Cocos2d-x và Creator 3.x, gọi Swift qua lớp bọc, vòng đời ứng dụng và Info.plist.
- “Build and maintain native bridges (... Objective-C/C++ for iOS)”
Cầu nối iOS ít người làm hơn Android vì cần Mac và Xcode, nên đây thường là khoảng trống của ứng viên. JD đòi cả hai nền tảng. Có thể nói trôi chảy về .mm, dispatch_async(dispatch_get_main_queue()) và cách gửi kết quả về game là điểm cộng rõ rệt.
🎯 Mục tiêu học tập
- Viết file .mm trộn C++ và Objective-C
- Chuyển đổi std::string ↔ NSString, dữ liệu ↔ JSON
- Gọi UIKit trên luồng chính, trả kết quả về luồng game
- Dùng reflection/ JsbBridge iOS trong Creator 3.x
- Gọi Swift qua lớp bọc và xử lý vòng đời ứng dụng
🟢 Objective-C++ và chuyển đổi kiểu
- File đuôi
.mmđược biên dịch như Objective-C++: dùng được cảstd::stringlẫnNSStringtrong một hàm. - Header C++ (
.h) dùng chung cho mọi nền tảng không được include header Objective-C; phần ObjC nằm trong.mm(mẫu “pimpl”/ cài đặt theo nền tảng). - ARC quản lý đối tượng Objective-C; đối tượng C++ do bạn quản lý. Giữ đối tượng ObjC trong lớp C++ thì dùng con trỏ
__strongtrong .mm hoặc bọc qua lớp ObjC.
// NativeBridge.h — header C++ dùng chung Android/iOS
#pragma once
#include <string>
#include <functional>
class NativeBridge {
public:
static void share(const std::string& text, const std::string& url);
static void confirm(const std::string& message, std::function<void(bool)> onResult);
};// NativeBridge-ios.mm — chỉ biên dịch cho iOS
#import <UIKit/UIKit.h>
#include "NativeBridge.h"
#include "cocos2d.h"
static NSString* toNS(const std::string& s) { return [NSString stringWithUTF8String:s.c_str()]; }
static UIViewController* topVC() {
UIViewController* vc = UIApplication.sharedApplication.keyWindow.rootViewController; // dự án mới: lấy từ UIWindowScene
while (vc.presentedViewController) vc = vc.presentedViewController;
return vc;
}
void NativeBridge::share(const std::string& text, const std::string& url) {
NSString* t = toNS(text); NSURL* u = [NSURL URLWithString:toNS(url)];
dispatch_async(dispatch_get_main_queue(), ^{ // UIKit chỉ trên luồng chính
UIActivityViewController* a = [[UIActivityViewController alloc] initWithActivityItems:@[t, u] applicationActivities:nil];
a.popoverPresentationController.sourceView = topVC().view; // bắt buộc trên iPad
[topVC() presentViewController:a animated:YES completion:nil];
});
}
void NativeBridge::confirm(const std::string& message, std::function<void(bool)> onResult) {
NSString* m = toNS(message);
dispatch_async(dispatch_get_main_queue(), ^{
UIAlertController* ac = [UIAlertController alertControllerWithTitle:nil message:m preferredStyle:UIAlertControllerStyleAlert];
auto reply = [onResult](bool ok) { // trả kết quả về luồng game
cocos2d::Director::getInstance()->getScheduler()->performFunctionInCocosThread([onResult, ok] { onResult(ok); });
};
[ac addAction:[UIAlertAction actionWithTitle:@"OK" style:UIAlertActionStyleDefault handler:^(UIAlertAction*) { reply(true); }]];
[ac addAction:[UIAlertAction actionWithTitle:@"Huỷ" style:UIAlertActionStyleCancel handler:^(UIAlertAction*) { reply(false); }]];
[topVC() presentViewController:ac animated:YES completion:nil];
});
}Block Objective-C bắt biến C++ theo giá trị (sao chép). Bắt onResult theo giá trị là an toàn; đừng bắt tham chiếu tới biến cục bộ C++ sẽ chết khi hàm trả về.
🟡 Creator 3.x: TypeScript ↔ Objective-C
// TypeScript → static method Objective-C (tên phương thức gồm cả dấu hai chấm cho từng tham số)
import { native, sys } from 'cc';
if (sys.isNative && sys.os === sys.OS.IOS) {
native.reflection.callStaticMethod('DeviceBridge', 'vibrate:', 'medium');
const model = native.reflection.callStaticMethod('DeviceBridge', 'deviceModel') as string;
}// DeviceBridge.h / .m (thêm vào target trong Xcode — thư mục native/engine/ios của project, nhớ commit)
#import <Foundation/Foundation.h>
#import <UIKit/UIKit.h>
#include <sys/utsname.h>
@interface DeviceBridge : NSObject
+ (void)vibrate:(NSString *)style;
+ (NSString *)deviceModel;
@end
@implementation DeviceBridge
+ (void)vibrate:(NSString *)style {
dispatch_async(dispatch_get_main_queue(), ^{
UIImpactFeedbackStyle s = [style isEqualToString:@"heavy"] ? UIImpactFeedbackStyleHeavy : UIImpactFeedbackStyleMedium;
[[[UIImpactFeedbackGenerator alloc] initWithStyle:s] impactOccurred];
});
}
+ (NSString *)deviceModel {
struct utsname info; uname(&info);
return [NSString stringWithUTF8String:info.machine]; // VD "iPhone14,5"
}
@endGửi ngược kết quả bất đồng bộ lên script: dùng JsbBridge phía iOS (đối xứng với Android ở module 13: script đăng ký native.bridge.onNative, native gọi gửi lên script) và đảm bảo việc gửi diễn ra trên luồng game. Tên lớp/ API phía iOS thay đổi theo phiên bản engine, hãy tra tài liệu của bản bạn dùng.
🟡 Swift trong dự án Cocos
- SDK hiện đại hay viết bằng Swift. Objective-C gọi được lớp Swift có
@objc/ kế thừa NSObject qua header tự sinhProjectName-Swift.h. - C++ không gọi Swift trực tiếp (trừ tính năng interop mới của Swift/ Xcode, chưa phổ biến trong dự án game): làm lớp bọc Objective-C mỏng ở giữa: C++ → .mm → Swift.
- Thêm file Swift lần đầu, Xcode hỏi tạo bridging header; cần bật “Always Embed Swift Standard Libraries” tuỳ cấu hình SDK.
🟢 Vòng đời ứng dụng và Info.plist
| Sự kiện iOS | Game nên làm |
|---|---|
| Vào nền (applicationDidEnterBackground) | Tạm dừng game, lưu tiến trình, dừng âm thanh |
| Quay lại (applicationWillEnterForeground) | Kiểm tra phiên đăng nhập, giao dịch IAP còn treo, hot update |
| Cảnh báo bộ nhớ | Xoá cache không thiết yếu (module 10) |
| Mở bằng deep link/ universal link | Chuyển tham số vào game qua bridge |
| Khoá Info.plist | Khi nào cần |
|---|---|
| NSUserTrackingUsageDescription | Hiện hộp thoại App Tracking Transparency (quảng cáo cá nhân hoá) |
| NSPhotoLibraryAddUsageDescription | Lưu ảnh chụp màn hình vào thư viện |
| NSCameraUsageDescription/ NSMicrophoneUsageDescription | Dùng camera/ micro |
| SKAdNetworkItems | Danh sách mạng quảng cáo (SDK quảng cáo hướng dẫn) |
Gọi API cần quyền mà thiếu khoá mô tả trong Info.plist, app crash ngay; mô tả mơ hồ dễ bị App Review từ chối. Viết mô tả cụ thể bằng ngôn ngữ người dùng.
🎤 Câu hỏi phỏng vấn thường gặp (trả lời to trước khi mở)
🎤 File .mm là gì, vì sao cần?
🎤 Vì sao phải dispatch về main queue khi gọi UIKit, và gửi kết quả về game thế nào?
🎤 Bạn tích hợp một SDK chỉ có Swift vào game Cocos2d-x thế nào?
🎤 Game bị App Review từ chối vì quyền. Bạn rà soát những gì?
⚠️ Sai lầm thường mắc
Vì sao nguy hiểm: Crash hoặc UI không hiện.
Cách làm đúng: dispatch_async main queue.
Vì sao nguy hiểm: Android không biên dịch được.
Cách làm đúng: Tách .h C++ và .mm.
Vì sao nguy hiểm: Crash khi chia sẻ trên iPad.
Cách làm đúng: Đặt sourceView/ sourceRect.
Vì sao nguy hiểm: Crash/ bị từ chối.
Cách làm đúng: Info.plist đầy đủ, rõ ràng.
Vì sao nguy hiểm: Mất tiến trình, âm thanh vẫn chạy.
Cách làm đúng: Hook vòng đời → game.
Vì sao nguy hiểm: Máy khác build thiếu bridge.
Cách làm đúng: Commit native/engine/ios phần tuỳ biến.
- .mm = Objective-C++; header C++ dùng chung không chứa ObjC.
- UIKit trên main queue; kết quả về game qua scheduler/ JsbBridge.
- Creator: native.reflection gọi static method ObjC (tên kèm dấu hai chấm).
- Swift qua lớp bọc @objc.
- Vòng đời app và Info.plist là một phần của bridge.
🧩 Tự kiểm tra (bấm để xem đáp án)
1. Tên phương thức ObjC cho + (void)share:(NSString*)t withUrl:(NSString*)u là:
A. share
B. share:withUrl:
C. shareWithUrl
2. Hiện UIAlertController phải ở:
A. Luồng game
B. Luồng chính (main queue)
C. Luồng nền
3. C++ muốn gọi SDK Swift:
A. Gọi trực tiếp
B. Qua lớp bọc Objective-C
C. Không thể
4. Chia sẻ trên iPad crash vì:
A. Thiếu popover sourceView
B. Thiếu Wi-Fi
C. Sai font
5. Hộp thoại ATT cần khoá Info.plist:
A. NSCameraUsageDescription
B. NSUserTrackingUsageDescription
C. CFBundleName
🏋️ Bài tập thực hành
Cài đặt phía iOS cho cùng giao diện bridge ở module 13: rung (haptic), model máy, hộp thoại xác nhận bất đồng bộ, chia sẻ ảnh chụp màn hình (có popover iPad), sự kiện vào nền/ quay lại đẩy lên game. Viết bảng so sánh API hai nền tảng.
💡 Gợi ý lời giải
📚 Tài nguyên học tập
- Apple: Threading Programming Guide / DispatchGCD, main queueTài liệu
- Apple: Importing Swift into Objective-CGọi Swift từ ObjCTài liệu
- Apple: App Tracking TransparencyQuyền theo dõiTài liệu
✅ Tự đánh giá hoàn thành
- Viết .mm trộn C++/ObjC
- Gọi UIKit đúng luồng
- Gọi ObjC từ TS bằng reflection
- Hiểu cách gọi Swift
- Rà soát Info.plist