Cocos Game Developer: từ JD đến offer 🏠
🏠 Trang chủ / Cocos Game Developer: từ JD đến offer / Phần 2 · Bộ nhớ, hiệu năng & chất lượng / Module 10
🧠 Module 10 / 21 · 1 tuần Nâng cao

Quản lý bộ nhớ: reference counting, giải phóng asset và săn rò rỉ

Reference counting của Cocos2d-x từng bước (create, retain, release, autorelease, container, addChild), thứ tự thao tác để không giải phóng nhầm, cache của engine, quản lý asset bằng addRef/ decRef trong Creator 3.x, các kiểu rò rỉ trong JS, và quy trình săn rò rỉ bằng Xcode Instruments, Android Studio Profiler, dumpsys.

Ref/ retain/ releaseAutoreleasePoolAsset addRef/decRefLeakInstruments/ Profiler
🎯 Dòng JD mà module này giúp bạn đáp ứng
  • “Optimization skills: memory management (including reference counting), memory-leak tracking”
  • “find and fix bottlenecks, bugs, memory leaks, and code errors in a timely manner”
📌 Vì sao nhà tuyển dụng hỏi phần này

JD nhắc đích danh “reference counting” và “memory-leak tracking”. Game di động bị hệ điều hành giết khi vượt bộ nhớ (iOS jetsam, Android low memory killer), thường không để lại crash log rõ ràng, chỉ thấy “game tự thoát” trong đánh giá 1 sao. Đây là chủ đề người phỏng vấn đào sâu nhất để phân biệt người đã từng tự tìm rò rỉ với người đọc lý thuyết.

🎯 Mục tiêu học tập

  • Giải thích chính xác vòng đời Ref trong Cocos2d-x
  • Viết code chuyển sở hữu đúng thứ tự (pool, cache)
  • Quản lý asset động bằng addRef/ decRef, release bundle
  • Nhận diện rò rỉ JS: listener, closure, cache tĩnh, persist node
  • Thực hiện quy trình săn rò rỉ bằng công cụ trên iOS/ Android

🟢 Reference counting trong Cocos2d-x

Thao tácrefCountGhi chú
Sprite::create()1 (đã autorelease)Nằm trong AutoreleasePool, sẽ bị release một lần cuối khung
parent->addChild(sprite)+1Parent giữ con
Cuối khung: pool xả−1Không ai giữ thì về 0 → delete
retain()+1Bạn tự giữ, phải có release() tương ứng
release()−1Về 0 → delete ngay
cocos2d::Vector::pushBack / Map::insert+1Container của engine retain phần tử; erase/ popBack release
removeFromParent()−1Parent thả con; nếu không ai khác giữ → delete
Quy tắc một câu

Ai tăng (retain, pushBack, addChild) thì người đó có trách nhiệm giảm. Khi chuyển đối tượng từ chủ này sang chủ khác, chủ mới nhận trước, chủ cũ thả sau, nếu không refCount chạm 0 giữa chừng.

// Pool tái sử dụng đạn: chú ý THỨ TỰ để refCount không chạm 0 giữa lúc chuyển
class BulletPool {
    cocos2d::Vector<Bullet*> _free;                       // Vector retain các viên đang rảnh
public:
    Bullet* obtain(cocos2d::Node* parent) {
        if (_free.empty()) { auto b = Bullet::create(); parent->addChild(b); return b; }
        Bullet* b = _free.back();
        parent->addChild(b);                              // 1) parent retain trước
        _free.popBack();                                  // 2) rồi Vector mới release
        b->reset();
        return b;
    }
    void recycle(Bullet* b) {
        b->stopAllActions();
        _free.pushBack(b);                                // 1) Vector retain trước
        b->removeFromParent();                            // 2) rồi parent release
    }
};

🟡 Rò rỉ kinh điển ở Cocos2d-x

Kiểu rò rỉVí dụCách sửa
retain không releaseGiữ texture/ action trong biến thành viên, quên release ở destructorRefPtr; hoặc cặp retain/release viết cạnh nhau
Vòng tham chiếuNode A retain B, B retain A (qua callback/ biến thành viên)Một chiều giữ mạnh, chiều kia con trỏ yếu; phá vòng ở onExit
Cache của engineTextureCache, SpriteFrameCache giữ mọi texture đã nạpKhi rời màn lớn: removeUnusedSpriteFrames() rồi removeUnusedTextures()
Listener tuỳ biến toàn cụcaddEventListenerWithFixedPriority không gỡremoveEventListener ở onExit
Đối tượng C++ thuần new không deleteParser, AIunique_ptr
void BattleScene::onExit() {
    Scene::onExit();
    unscheduleAllCallbacks();
    _eventDispatcher->removeEventListener(_customListener);
    // Rời màn chiến đấu nặng: dọn cache texture không còn ai dùng
    cocos2d::SpriteFrameCache::getInstance()->removeUnusedSpriteFrames();
    cocos2d::Director::getInstance()->getTextureCache()->removeUnusedTextures();
    CCLOG("%s", cocos2d::Director::getInstance()->getTextureCache()->getCachedTextureInfo().c_str());   // in ra để kiểm tra
}

🟡 Creator 3.x: GC cho JS, đếm tham chiếu cho asset

Đối tượng JavaScript do GC dọn khi không còn ai tham chiếu. Nhưng asset (texture, SpriteFrame, Prefab, âm thanh, Spine) chiếm bộ nhớ native/ GPU và được assetManager quản lý bằng đếm tham chiếu cùng đồ thị phụ thuộc. Asset nạp động bằng code phải tự quản lý:

import { _decorator, Component, resources, Prefab, SpriteFrame, Sprite, assetManager, instantiate, Node } from 'cc';
const { ccclass } = _decorator;

@ccclass('EventBanner')
export class EventBanner extends Component {
    private frame: SpriteFrame | null = null;

    async show(path: string) {
        const sf = await new Promise<SpriteFrame>((ok, fail) =>
            resources.load(`${path}/spriteFrame`, SpriteFrame, (e, a) => e ? fail(e) : ok(a)));
        if (!this.isValid) return;                 // component đã bị huỷ trong lúc chờ: KHÔNG addRef
        this.release();                            // thả ảnh cũ nếu đổi banner
        sf.addRef();                               // tôi đang dùng asset này
        this.frame = sf;
        this.getComponent(Sprite)!.spriteFrame = sf;
    }
    private release() {
        if (this.frame) { this.frame.decRef(); this.frame = null; }   // về 0 → assetManager có thể giải phóng
    }
    onDestroy() { this.release(); }
}
// Giải phóng theo bundle khi rời tính năng:   assetManager.getBundle('event_tet')?.releaseAll();
// Scene có tuỳ chọn "Auto Release Assets": asset tham chiếu tĩnh bởi scene được giải phóng khi chuyển scene
// (asset nạp động vẫn phải addRef/decRef như trên).
Rò rỉ phía JSVì saoCách sửa
Listener trên bus toàn cục không offBus giữ callback + target → giữ cả component, nodeon/off đối xứng; targetOff(this)
Closure giữ nodesetTimeout/ promise/ callback SDK tham chiếu node đã huỷKiểm tra isValid, huỷ callback, dùng schedule của component
Cache tĩnh không giới hạnMap tĩnh lưu mọi icon đã tảiGiới hạn kích thước (LRU), xoá khi rời tính năng
Persist root node giữ tham chiếu scene cũScene cũ không thể giải phóngChỉ giữ dịch vụ toàn cục
Asset nạp động không decRefTexture ở lại GPU mãiaddRef/decRef theo chủ sở hữu, release bundle

🔴 Quy trình săn rò rỉ

Kịch bản lặpMenu → màn chơi → menu, 10 vòng
ĐoRAM sau mỗi vòng, cùng một điểm
Xác nhận xu hướngTăng đều = rò rỉ (công cụ bên dưới)
Chụp & soẢnh chụp heap/ Allocations vòng 2 và 6
Khoanh vùngLoại đối tượng tăng: texture? node? listener?
RAM (MB) sau mỗi vòng vào/ra màn chơi17419120822424125812345678910VòngỔn địnhRò rỉ ~8 MB/vòng
Vòng đầu tăng do cache khởi động là bình thường. Đường đỏ tăng đều mỗi vòng: sau 30–40 vòng chơi, máy 2–3 GB RAM sẽ giết game.
Nền tảngCông cụDùng để
iOSXcode Instruments: Allocations, Leaks, VM Tracker; Memory Graph DebuggerTheo dõi cấp phát theo thời gian (Mark Generation giữa các vòng), tìm chu trình tham chiếu
AndroidAndroid Studio Profiler (Memory, native allocations)Xem Java/ native heap, ghi cấp phát native
Androidadb shell dumpsys meminfo <package>Số liệu nhanh: tổng PSS, Native Heap, Graphics
Web buildChrome DevTools: Heap snapshot, so sánh snapshotRò rỉ phía JS: listener, closure (dễ thấy nhất)
EngineTextureCache::getCachedTextureInfo (2d-x); assetManager.assets (Creator)Liệt kê texture/ asset đang giữ
Mẹo: build web để săn rò rỉ JS

Nhiều rò rỉ phía script (listener, closure, cache) giống nhau trên web và native. Chạy bản web, chụp heap snapshot sau vòng 2 và vòng 6, lọc “Objects allocated between snapshots”: tìm nhanh hơn nhiều so với công cụ native. Rò rỉ texture/ native thì vẫn phải dùng Instruments/ Profiler.

# Android: theo dõi bộ nhớ trong lúc chạy kịch bản lặp
adb shell dumpsys meminfo com.studio.fruitmerge | grep -E "TOTAL|Native Heap|Graphics"
# Lặp lại sau mỗi vòng, ghi số vào công cụ phát hiện rò rỉ ở trên

🟢 Phản ứng khi hệ điều hành báo thiếu bộ nhớ

  • iOS gửi cảnh báo bộ nhớ (applicationDidReceiveMemoryWarning) trước khi giết app; Android gọi onTrimMemory với các mức. Chuyển tín hiệu này vào game để xoá cache không thiết yếu (texture màn khác, âm thanh chưa dùng).
  • Đặt ngân sách bộ nhớ theo hạng thiết bị (ví dụ máy 2 GB RAM: game không vượt ~600–700 MB); hạ chất lượng texture cho máy yếu.
  • Theo dõi tỷ lệ bị hệ điều hành giết (Firebase Crashlytics/ Play Console vitals) như một chỉ số chất lượng.

🎤 Câu hỏi phỏng vấn thường gặp (trả lời to trước khi mở)

🎤 Giải thích reference counting trong Cocos2d-x. Sprite::create() rồi không addChild thì sao?
create() trả đối tượng refCount 1 đã autorelease (trong pool). addChild +1, pool xả cuối khung −1. Không addChild/ retain thì cuối khung refCount về 0 → bị xoá; giữ con trỏ đó và dùng ở khung sau → crash use-after-free.
🎤 Khi nào bạn gọi retain() thủ công? Rủi ro?
Khi giữ đối tượng ngoài cây node qua nhiều khung (cache, pool không dùng Vector, đối tượng chờ callback). Rủi ro: quên release → rò rỉ; release thừa → crash. Ưu tiên RefPtr hoặc container của engine; retain/release viết cặp, có comment chủ sở hữu.
🎤 Bạn đã tìm một rò rỉ bộ nhớ thật như thế nào? (câu hành vi + kỹ thuật)
Kể STAR: triệu chứng (game tự thoát sau ~20 phút trên máy 2 GB), dựng kịch bản lặp, đo dumpsys/ Instruments thấy +8 MB/vòng, so snapshot thấy texture popup sự kiện tăng, nguyên nhân: asset nạp động không decRef + listener bus không off, sửa, đo lại ổn định, thêm kiểm tra vào quy trình review.
🎤 Creator 3.x: texture nạp bằng resources.load có tự giải phóng không?
Không tự động theo ý bạn: asset nạp động cần addRef khi dùng, decRef khi thôi (hoặc release thủ công/ release bundle). Scene “Auto Release Assets” chỉ xử lý tài nguyên phụ thuộc tĩnh của scene. Phải thiết kế ai là chủ sở hữu asset.
🎤 Vì sao JavaScript có GC mà vẫn rò rỉ?
GC chỉ dọn đối tượng không còn ai tham chiếu. Listener trên đối tượng sống lâu, closure trong callback chưa huỷ, cache tĩnh, persist node vẫn tham chiếu → không dọn được. Ngoài ra asset native/ GPU nằm ngoài GC, do assetManager quản lý.

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

❌ Giữ con trỏ đối tượng autorelease mà không retain

Vì sao nguy hiểm: Crash ở khung sau.

Cách làm đúng: RefPtr/ retain hoặc addChild.

❌ Chuyển chủ sai thứ tự (thả trước, nhận sau)

Vì sao nguy hiểm: refCount chạm 0, đối tượng bị xoá giữa chừng.

Cách làm đúng: Chủ mới nhận trước, chủ cũ thả sau.

❌ Không bao giờ dọn TextureCache

Vì sao nguy hiểm: RAM tăng qua mỗi màn.

Cách làm đúng: removeUnused... khi rời màn lớn, kiểm tra bằng log.

❌ Asset nạp động không decRef

Vì sao nguy hiểm: Texture ở lại GPU.

Cách làm đúng: addRef/decRef theo chủ, release bundle.

❌ Đo RAM một lần rồi kết luận

Vì sao nguy hiểm: Nhầm cache khởi động với rò rỉ.

Cách làm đúng: Kịch bản lặp 8–10 vòng, xem xu hướng.

❌ Chỉ thử trên máy nhiều RAM

Vì sao nguy hiểm: Không thấy lỗi bị giết app.

Cách làm đúng: Thiết bị 2–3 GB RAM trong bộ thử.

📌 Cần nhớ
  • create() = refCount 1 + autorelease; addChild/ pushBack/ retain tăng; pool xả/ removeFromParent/ release giảm.
  • Chuyển sở hữu: nhận trước, thả sau.
  • Cache engine phải dọn chủ động khi rời màn lớn.
  • Creator: JS do GC, asset do đếm tham chiếu: addRef/decRef, release bundle.
  • Săn rò rỉ: kịch bản lặp → xu hướng → snapshot so sánh → khoanh vùng.

🧩 Tự kiểm tra (bấm để xem đáp án)

1. Sprite::create() rồi lưu vào biến thành viên (không retain, không addChild). Khung sau:
A. Vẫn dùng được
B. Đã bị giải phóng → dùng sẽ crash
C. refCount = 2
Đáp án: B. Pool xả cuối khung.
2. cocos2d::Vector::pushBack(obj) làm:
A. Không đổi refCount
B. retain obj
C. release obj
Đáp án: B. Container giữ phần tử.
3. Asset nạp bằng resources.load đang hiển thị trên banner, nên:
A. Không làm gì
B. addRef khi dùng, decRef khi thôi
C. Gọi GC
Đáp án: B. Quản lý theo chủ sở hữu.
4. RAM tăng đều 8 MB mỗi vòng vào/ra màn chơi nghĩa là:
A. Bình thường
B. Dấu hiệu rò rỉ
C. Do màn hình to
Đáp án: B. Xu hướng tăng đều.
5. Công cụ nhanh nhất để tìm rò rỉ listener phía JS:
A. Chrome DevTools heap snapshot trên bản web
B. Đồng hồ bấm giờ
C. Xcode GPU capture
Đáp án: A. So sánh snapshot.

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

Cài rò rỉ rồi tự tìm

Trong một project Creator: tạo màn chơi có (1) listener bus không off, (2) banner nạp động không decRef, (3) Map tĩnh cache icon không giới hạn. Chạy 10 vòng menu ↔ màn chơi, ghi RAM, dùng công cụ phát hiện rò rỉ ở trên. Tìm lần lượt từng lỗi bằng heap snapshot (web) và dumpsys/ Instruments (native), sửa và đo lại.

💡 Gợi ý lời giải
Để dễ thấy, làm banner là texture lớn (2048×2048). Ghi số liệu thành bảng: lỗi → công cụ phát hiện → cách sửa → RAM sau sửa. Đây chính là một câu chuyện STAR thật cho buổi phỏng vấn (module 21).

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

✅ Tự đánh giá hoàn thành

  • Mô phỏng 3 kịch bản reference counting
  • Viết pool đúng thứ tự sở hữu
  • Quản lý asset bằng addRef/decRef
  • Chạy kịch bản lặp đo RAM
  • Làm bài tập cài và tìm rò rỉ
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.