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 17
🔄 Module 17 / 21 · 1 tuần Nâng cao

Hot update & live-update: manifest, tải chênh lệch, khôi phục và chính sách store

Thứ gì cập nhật nóng được và thứ gì không, chính sách store, cơ chế AssetsManager của Cocos (manifest, so sánh phiên bản, tải file khác md5, search path, khởi động lại), sinh manifest trong pipeline, bẫy cache cũ khi cài bản store mới, khôi phục khi bản cập nhật lỗi, phát hành theo nhóm, và các phương án live-ops an toàn hơn (remote config, bundle từ xa).

AssetsManagerManifestSearch pathsRollbackRemote configCDN
🎯 Dòng JD mà module này giúp bạn đáp ứng
  • “Build game patches, hot updates, and live-update flows”
  • “Nice to have: Experience with hot update and live-update pipelines”
📌 Vì sao nhà tuyển dụng hỏi phần này

Hot update là năng lực “đặc sản” của Cocos (nhờ script JS/ Lua) và là lý do nhiều studio chọn Cocos cho game live-ops. Nhưng làm sai thì có thể làm hỏng game của toàn bộ người chơi trong một lần đẩy, không có cách sửa trừ khi người chơi gỡ cài đặt. Người phỏng vấn sẽ hỏi thiết kế hệ thống hot update như một câu system design.

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

  • Phân biệt nội dung cập nhật nóng được/ không được và giới hạn chính sách
  • Giải thích cơ chế manifest, so sánh phiên bản, search path
  • Cài luồng hot update trong Creator 3.x
  • Thiết kế pipeline sinh manifest, CDN, phát hành theo nhóm
  • Xử lý cache cũ khi nâng cấp store và khôi phục khi lỗi

🟢 Cập nhật được gì, không được gì

LoạiHot update?Ghi chú
Script game (JS biên dịch từ TS; Lua/JS ở 2d-x có binding)Được (về kỹ thuật)Chịu ràng buộc chính sách store
Ảnh, âm thanh, Spine, prefab, scene, cấu hình JSONĐượcPhổ biến và ít rủi ro chính sách nhất
Code C++/ Java/ Objective-C, engine, SDK, quyền, icon, tên appKhôngPhải phát hành bản store
Logic C++ thuần của game Cocos2d-xKhôngGame 2d-x thuần C++ chỉ cập nhật được asset/ cấu hình
Chính sách store

App Store Review Guidelines (mục 2.5.2 và các mục liên quan) hạn chế việc app tải code làm thay đổi tính năng/ bản chất app sau khi duyệt; Google Play cũng có chính sách về tải code thực thi. Thực hành an toàn: dùng hot update cho nội dung, cấu hình, sửa lỗi nhỏ trong phạm vi tính năng đã được duyệt; tính năng mới đi qua bản store. Luôn đọc chính sách hiện hành và để quản lý sản phẩm/ pháp chế quyết định phạm vi.

🟡 Cơ chế: manifest và search path

Luồng AssetsManager
Khởi độngSearch path ưu tiên thư mục cập nhật
Tải version.manifestFile nhỏ: chỉ có version
So phiên bảnremote > local?
Tải project.manifestDanh sách file + md5 + size
Tải file khác md5Vào thư mục tạm, kiểm tra md5
Hoàn tấtGhi search path, khởi động lại game
{
  "packageUrl": "https://cdn.example.com/fruitmerge/hotupdate/1.4.3/",
  "remoteManifestUrl": "https://cdn.example.com/fruitmerge/hotupdate/project.manifest",
  "remoteVersionUrl": "https://cdn.example.com/fruitmerge/hotupdate/version.manifest",
  "version": "1.4.3",
  "assets": {
    "assets/main/index.js":                 { "size": 415500, "md5": "c90b7e0f..." },
    "assets/resources/spine/hero.skel":     { "size": 98200,  "md5": "5af2a113..." },
    "assets/resources/event/tet.png":       { "size": 260000, "md5": "e0219c4d..." }
  },
  "searchPaths": []
}

Search path: khi engine tìm một file, nó thử lần lượt các thư mục trong danh sách. Đặt thư mục chứa bản cập nhật (trong vùng ghi được của app) lên đầu, file mới sẽ “đè” file trong gói cài mà không cần sửa gói.

🟡 Cài đặt trong Creator 3.x

import { _decorator, Component, native, sys, game, Asset } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('HotUpdate')
export class HotUpdate extends Component {
    @property(Asset) localManifest: Asset | null = null;          // project.manifest đóng trong gói cài
    private am: native.AssetsManager | null = null;
    private storagePath = '';

    start() {
        if (!sys.isNative) return;                                // web không dùng cơ chế này
        this.storagePath = native.fileUtils.getWritablePath() + 'hotupdate/';
        this.am = new native.AssetsManager('', this.storagePath, compareVersion);
        this.am.setVerifyCallback((path: string, asset: any) => {
            // Kiểm tra md5 file đã tải (tính md5 qua module native hoặc thư viện); trả false để tải lại
            return true;
        });
        this.am.loadLocalManifest(this.localManifest!.nativeUrl);
        if (!this.am.getLocalManifest() || !this.am.getLocalManifest().isLoaded()) { this.enterGame(); return; }
        this.am.setEventCallback(this.onCheck.bind(this));
        this.am.checkUpdate();
    }

    private onCheck(e: native.EventAssetsManager) {
        switch (e.getEventCode()) {
            case native.EventAssetsManager.NEW_VERSION_FOUND:
                this.am!.setEventCallback(this.onUpdate.bind(this));
                this.am!.update();
                break;
            case native.EventAssetsManager.ALREADY_UP_TO_DATE:
            case native.EventAssetsManager.ERROR_NO_LOCAL_MANIFEST:
            case native.EventAssetsManager.ERROR_DOWNLOAD_MANIFEST:
            case native.EventAssetsManager.ERROR_PARSE_MANIFEST:
                this.enterGame();                                 // lỗi mạng/ server: vẫn cho chơi bằng bản hiện có
                break;
        }
    }

    private onUpdate(e: native.EventAssetsManager) {
        switch (e.getEventCode()) {
            case native.EventAssetsManager.UPDATE_PROGRESSION:
                this.showProgress(e.getPercentByFile());
                break;
            case native.EventAssetsManager.UPDATE_FINISHED: {
                const paths = native.fileUtils.getSearchPaths();
                const newPaths = this.am!.getLocalManifest().getSearchPaths();
                const merged = [...newPaths, ...paths.filter(p => newPaths.indexOf(p) < 0)];
                localStorage.setItem('HotUpdateSearchPaths', JSON.stringify(merged));   // main.js đọc khi khởi động
                native.fileUtils.setSearchPaths(merged);
                game.restart();
                break;
            }
            case native.EventAssetsManager.UPDATE_FAILED:
                this.am!.downloadFailedAssets();                  // thử lại file lỗi (giới hạn số lần)
                break;
            case native.EventAssetsManager.ERROR_UPDATING:
            case native.EventAssetsManager.ERROR_DECOMPRESS:
                this.enterGame();
                break;
        }
    }
    private showProgress(p: number) {} private enterGame() {}
}

export function compareVersion(a: string, b: string): number {    // > 0 nếu a mới hơn b
    const x = a.split('.'), y = b.split('.');
    for (let i = 0; i < Math.max(x.length, y.length); i++) {
        const d = (parseInt(x[i] || '0', 10)) - (parseInt(y[i] || '0', 10));
        if (d !== 0) return d;
    }
    return 0;
}

Search path phải được nạp trước khi engine tải script: đoạn đọc HotUpdateSearchPaths và gọi setSearchPaths được chèn vào đầu main.js của bản build native (qua build template/ hook sau build). Xem mẫu trong tài liệu “Hot Update” của phiên bản Creator bạn dùng; Cocos2d-x có lớp tương đương AssetsManagerEx.

🔴 Bẫy chết người: cache cũ sau khi cập nhật store

🎬 Bản store mới, game chạy code cũ

Người chơi đang ở bản hot update 1.4.3 (lưu trong thư mục ghi được). Studio phát hành bản store 1.5.0 có native mới và script mới. Sau khi cập nhật từ store, search path vẫn trỏ vào thư mục hot update cũ → game chạy script 1.4.3 trên native 1.5.0 → crash hoặc lỗi lạ, chỉ hết khi gỡ cài đặt.

// Chạy sớm nhất có thể khi khởi động (main.js hoặc màn boot)
const STORE_VERSION = '1.5.0';                         // phiên bản gói cài (lấy từ native/ cấu hình build)
const saved = localStorage.getItem('StoreVersion');
if (saved !== STORE_VERSION) {
    native.fileUtils.removeDirectory(native.fileUtils.getWritablePath() + 'hotupdate/');   // xoá bản cập nhật cũ
    localStorage.removeItem('HotUpdateSearchPaths');
    localStorage.setItem('StoreVersion', STORE_VERSION);
    // khởi động lại search path về mặc định của gói cài
}
Rủi roBiện pháp
Bản hot update lỗi làm crash khi khởi độngCờ “đang khởi động” ghi trước khi nạp bản mới, xoá khi vào menu thành công; lần sau thấy cờ còn → quay về bản trước/ gói gốc
Tải dở, mất mạngTải vào thư mục tạm, chỉ đổi sang khi đủ và đúng md5; tiếp tục tải được
Manifest bị giả mạo/ CDN bị tấn côngHTTPS, ký manifest (chữ ký số kiểm tra bằng khoá công khai trong app), kiểm tra md5 từng file
Đẩy lỗi cho toàn bộ người chơiPhát hành theo nhóm: remoteVersionUrl khác nhau theo % người chơi/ cohort, theo dõi crash rồi mở rộng
Bản hot update không tương thích nativeManifest ghi yêu cầu phiên bản native tối thiểu; app native cũ thì không áp dụng/ yêu cầu cập nhật store
CDN cache file cũĐường dẫn có version (thư mục 1.4.3/), cache-control hợp lý cho version.manifest

🟢 Pipeline và phương án live-ops khác

BuildCreator build native
Sinh manifestScript tạo project/version.manifest (md5, size)
Kiểm thửCài bản store cũ + áp bản cập nhật trên thiết bị thật
Upload CDNThư mục có version; manifest cập nhật sau cùng
Phát hành theo nhóm5% → 25% → 100%, theo dõi crash
Nhu cầu live-opsCông cụ phù hợp hơn hot update script
Đổi giá, phần thưởng, tần suất quảng cáo, bật/tắt tính năngRemote config (Firebase Remote Config hoặc server riêng)
Thêm màn chơi, skin sự kiệnAsset Bundle từ xa (tải theo nhu cầu) + cấu hình
Thử nghiệm A/BRemote config + analytics
Sửa lỗi logic nghiêm trọngHot update script (trong phạm vi chính sách) hoặc bản store khẩn

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

🎤 Thiết kế hệ thống hot update cho game Cocos Creator có 1 triệu người chơi.
Manifest hai tầng (version nhỏ + project đầy đủ), CDN có thư mục theo version, tải chênh lệch theo md5, thư mục tạm + kiểm tra toàn vẹn, ký manifest + HTTPS, search path nạp trong main.js, khởi động lại; xoá cache khi đổi bản store; phiên bản native tối thiểu; cờ khởi động để rollback; phát hành theo nhóm + theo dõi crash; tiến độ và cho chơi khi lỗi mạng; phạm vi theo chính sách store; pipeline sinh manifest tự động và test trên thiết bị.
🎤 Sau khi người chơi cập nhật từ store, game crash. Bạn nghi gì đầu tiên?
Cache hot update cũ vẫn ở đầu search path → script cũ chạy trên native mới. Khắc phục: so sánh phiên bản store đã lưu, xoá thư mục cập nhật và reset search path khi khác.
🎤 Thứ gì không thể hot update?
Code native (C++/Java/ObjC), engine, SDK, quyền, icon, tên. Với Cocos2d-x thuần C++ chỉ cập nhật được asset/ cấu hình.
🎤 Làm sao rollback nếu bản hot update làm crash khi khởi động?
Ghi cờ boot trước khi nạp bản mới, xoá khi vào menu ổn định; lần mở sau thấy cờ còn thì xoá/ chuyển về thư mục phiên bản trước (giữ 1 bản dự phòng) hoặc về gói gốc, báo về server; dừng phát hành theo nhóm.
🎤 Hot update có vi phạm chính sách App Store không?
Có giới hạn: không được tải code thay đổi tính năng/ bản chất app sau duyệt. Thực hành: dùng cho nội dung, cấu hình, sửa lỗi trong phạm vi tính năng đã duyệt; tính năng mới qua bản store; đọc guideline hiện hành và thống nhất với PM/ pháp chế.

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

❌ Không xoá cache khi đổi bản store

Vì sao nguy hiểm: Crash hàng loạt sau cập nhật store.

Cách làm đúng: So phiên bản store, xoá thư mục cập nhật.

❌ Ghi đè trực tiếp không qua thư mục tạm

Vì sao nguy hiểm: Hỏng khi mất mạng giữa chừng.

Cách làm đúng: Tải tạm, kiểm tra, rồi mới đổi.

❌ Không có rollback

Vì sao nguy hiểm: Một lần đẩy lỗi làm hỏng game toàn bộ người chơi.

Cách làm đúng: Cờ khởi động + bản dự phòng.

❌ Đẩy 100% ngay

Vì sao nguy hiểm: Lỗi lan toàn bộ.

Cách làm đúng: Phát hành theo nhóm, theo dõi crash.

❌ Manifest không ký, HTTP

Vì sao nguy hiểm: Bị chèn nội dung độc hại.

Cách làm đúng: HTTPS + chữ ký + md5.

❌ Dùng hot update cho tính năng mới lớn

Vì sao nguy hiểm: Rủi ro chính sách store.

Cách làm đúng: Bản store cho tính năng mới; remote config cho tham số.

📌 Cần nhớ
  • Script/ asset/ cấu hình cập nhật được; native, SDK, quyền thì không.
  • version.manifest nhỏ → project.manifest → tải file khác md5 → search path → restart.
  • Search path phải nạp trong main.js trước khi tải script.
  • Xoá cache cập nhật khi đổi bản store; có rollback, ký manifest, phát hành theo nhóm.
  • Remote config và bundle từ xa cho live-ops an toàn hơn.

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

1. Vì sao tách version.manifest nhỏ khỏi project.manifest?
A. Cho đẹp
B. Kiểm tra nhanh có bản mới mà không tải danh sách lớn
C. Bắt buộc của iOS
Đáp án: B. Tiết kiệm băng thông.
2. Search path trỏ thư mục cập nhật lên đầu nhằm:
A. File mới được ưu tiên đè file trong gói
B. Xoá gói cài
C. Tăng FPS
Đáp án: A. Cơ chế ưu tiên tìm file.
3. compareVersion('1.10.0','1.9.9'):
A. Âm
B. Dương
C. 0
Đáp án: B. 10 > 9.
4. Có thể hot update thư viện SDK quảng cáo native không?
A. Có
B. Không, cần bản store
C. Chỉ trên Android
Đáp án: B. Native không hot update.
5. Cờ “đang khởi động” chưa được xoá ở lần mở trước nghĩa là:
A. Bình thường
B. Bản cập nhật có thể làm crash, cần rollback
C. Mạng chậm
Đáp án: B. Phát hiện khởi động thất bại.

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

Hot update đầu–cuối trên thiết bị thật

Dựng hot update cho project Creator: script Node.js sinh manifest (duyệt thư mục build, tính md5/size), server tĩnh cục bộ làm CDN, màn boot có tiến độ, đổi một màu nút + một file cấu hình ở bản 1.0.1, kiểm tra cập nhật thành công; mô phỏng mất mạng giữa chừng; mô phỏng cài “bản store” mới và chứng minh cache cũ bị xoá; thêm rollback bằng cờ khởi động.

💡 Gợi ý lời giải
Tham khảo script version_generator trong ví dụ hot update chính thức của Cocos. Server cục bộ: npx http-server ./remote -p 8080, điện thoại cùng mạng Wi-Fi truy cập IP máy tính (Android cần cho phép cleartext cho bản debug hoặc dùng HTTPS). Dùng công cụ so sánh manifest ở trên để kiểm tra danh sách file cần tải.

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

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

  • Phân loại cập nhật được/ không được
  • Vẽ luồng manifest
  • Cài HotUpdate component
  • Xử lý cache khi đổi bản store
  • Thiết kế rollback + phát hành theo nhóm
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.