Cocos Game Developer: từ JD đến offer 🏠
🏠 Trang chủ / Cocos Game Developer: từ JD đến offer / Phần 3 · Native, SDK, build & phát hành / Module 14
🍎 Module 14 / 21 · 4–5 ngày Nâng cao

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.

Objective-C++.mmARCmain threadreflection iOSSwift interop
🎯 Dòng JD mà module này giúp bạn đáp ứng
  • “Build and maintain native bridges (... Objective-C/C++ for iOS)”
📌 Vì sao nhà tuyển dụng hỏi phần này

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::string lẫn NSString trong 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ỏ __strong trong .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];
    });
}
Khối (block) bắt std::function

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"
}
@end

Gử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ự sinh ProjectName-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 iOSGame 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 linkChuyển tham số vào game qua bridge
Khoá Info.plistKhi nào cần
NSUserTrackingUsageDescriptionHiện hộp thoại App Tracking Transparency (quảng cáo cá nhân hoá)
NSPhotoLibraryAddUsageDescriptionLưu ảnh chụp màn hình vào thư viện
NSCameraUsageDescription/ NSMicrophoneUsageDescriptionDùng camera/ micro
SKAdNetworkItemsDanh sách mạng quảng cáo (SDK quảng cáo hướng dẫn)
Thiếu mô tả quyền = bị từ chối hoặc crash

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?
Objective-C++: cho phép trộn C++ và Objective-C trong một đơn vị biên dịch; dùng để cài đặt phần iOS của lớp C++ dùng chung (gọi UIKit/ SDK) mà header C++ vẫn sạch cho Android.
🎤 Vì sao phải dispatch về main queue khi gọi UIKit, và gửi kết quả về game thế nào?
UIKit chỉ an toàn trên luồng chính; game loop chạy luồng khác (tuỳ engine/ cấu hình). Dùng dispatch_async(dispatch_get_main_queue()) cho UI; kết quả trả về game qua scheduler của engine (performFunctionInCocosThread) hoặc JsbBridge trên luồng game.
🎤 Bạn tích hợp một SDK chỉ có Swift vào game Cocos2d-x thế nào?
Lớp bọc Objective-C (@objc) gọi Swift; C++ gọi qua .mm. Cấu hình bridging header/ module, Swift runtime; giữ giao diện C++ không đổi giữa hai nền tảng.
🎤 Game bị App Review từ chối vì quyền. Bạn rà soát những gì?
Khoá mô tả quyền đầy đủ và rõ ràng, chỉ xin quyền khi cần (đúng ngữ cảnh), ATT trước khi theo dõi, nhãn quyền riêng tư (privacy nutrition label) khớp SDK đang dùng, tệp privacy manifest của SDK.

⚠️ Sai lầm thường mắc

❌ Gọi UIKit ngoài luồng chính

Vì sao nguy hiểm: Crash hoặc UI không hiện.

Cách làm đúng: dispatch_async main queue.

❌ Include header ObjC trong header C++ dùng chung

Vì sao nguy hiểm: Android không biên dịch được.

Cách làm đúng: Tách .h C++ và .mm.

❌ Quên popover cho iPad

Vì sao nguy hiểm: Crash khi chia sẻ trên iPad.

Cách làm đúng: Đặt sourceView/ sourceRect.

❌ Thiếu khoá mô tả quyền

Vì sao nguy hiểm: Crash/ bị từ chối.

Cách làm đúng: Info.plist đầy đủ, rõ ràng.

❌ Không xử lý vào nền/ quay lại

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.

❌ Không commit thư mục native tuỳ biến

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.

📌 Cần nhớ
  • .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
Đáp án: B. Selector gồm các phần có dấu hai chấm.
2. Hiện UIAlertController phải ở:
A. Luồng game
B. Luồng chính (main queue)
C. Luồng nền
Đáp án: B. UIKit.
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ể
Đáp án: B. Cầu nối phổ biến.
4. Chia sẻ trên iPad crash vì:
A. Thiếu popover sourceView
B. Thiếu Wi-Fi
C. Sai font
Đáp án: A. iPad yêu cầu.
5. Hộp thoại ATT cần khoá Info.plist:
A. NSCameraUsageDescription
B. NSUserTrackingUsageDescription
C. CFBundleName
Đáp án: B. App Tracking Transparency.

🏋️ Bài tập thực hành

NativeBridge iOS khớp với Android

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
Ảnh chụp: Creator có thể render ra texture/ đọc pixel rồi lưu file vào writable path, truyền đường dẫn xuống native; native tạo UIImage từ file. Sự kiện nền: Creator đã có game.on(Game.EVENT_HIDE/ EVENT_SHOW); vẫn nên biết cách hook AppDelegate cho SDK cần.

📚 Tài nguyên học tập

✅ 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
Lưu ý: Cocos Creator, Cocos2d-x, Spine, SDK của Google/ Apple/ các mạng quảng cáo thay đổi API theo phiên bản. Code mẫu viết cho Cocos Creator 3.8.x và Cocos2d-x 3.17/4.0; luôn đối chiếu tài liệu chính thức của phiên bản dự án bạn đang dùng. Chính sách App Store/ Google Play (đăng nhập, quyền riêng tư, tải code, target API) được tóm tắt ở mức tham khảo, hãy đọc bản mới nhất trước khi phát hành. Khoá học độc lập, không liên kết với Cocos, Esoteric Software hay nhà tuyển dụng nào.