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 12
🧪 Module 12 / 21 · 4–5 ngày Trung cấp

Unit test logic game, CI, phân tích tĩnh và báo cáo crash

Thiết kế logic có thể test (tách khỏi engine, RNG có seed, service giả), viết test bằng Jest cho TypeScript và GoogleTest cho C++, đưa test và lint vào CI, phân tích tĩnh, kiểm thử tự động trên thiết bị ở mức cơ bản, và báo cáo crash có symbol.

JestGoogleTestSeeded RNGCICrashlytics
🎯 Dòng JD mà module này giúp bạn đáp ứng
  • “Write unit tests for critical game logic”
  • “Nice to have: Experience with automated testing and unit-test frameworks”
📌 Vì sao nhà tuyển dụng hỏi phần này

Nhiều đội game không có test, nên người viết được test đúng chỗ là điểm cộng lớn. Người phỏng vấn không cần độ phủ 90%; họ muốn thấy bạn biết “critical game logic” là gì (kinh tế, phần thưởng, luật chơi, lưu game, so sánh phiên bản hot update) và cách thiết kế code để test được.

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

  • Xác định logic quan trọng cần test
  • Thiết kế code test được: thuần, RNG có seed, interface
  • Viết test bằng Jest (TS) và GoogleTest (C++)
  • Đưa test, lint vào CI
  • Thiết lập báo cáo crash có symbol

🟢 Test cái gì?

LogicVì sao quan trọngVí dụ test
Luật chơi (match, gravity, combo)Lỗi là game sai, người chơi kẹt mànBàn cờ cho trước → các ô bị ăn
Kinh tế (giá, phần thưởng, giới hạn)Lỗi là mất doanh thu/ lạm phát tiền ảoKhông đủ xu thì không mua được, số dư không đổi
Lưu game & migrateLỗi là mất tiến trình người chơiBản lưu v1 → v2 đúng trường
So sánh phiên bản hot updateLỗi là không cập nhật hoặc cập nhật vòng lặp1.10.0 > 1.9.9
FSM luồng gameLỗi là kẹt trạng tháiChuyển không hợp lệ phải báo lỗi
Không nên unit testBố cục UI, animation, shaderKiểm tra bằng mắt/ ảnh chụp, test tay theo checklist

🟡 Jest cho TypeScript (logic thuần)

// assets/scripts/core/MatchFinder.ts — KHÔNG import 'cc'
export type Grid = ReadonlyArray<ReadonlyArray<number>>;   // -1 = ô trống

export function findMatches(g: Grid, min = 3): Set<string> {
    const out = new Set<string>();
    const rows = g.length, cols = rows ? g[0].length : 0;
    const scan = (len: number, at: (i: number) => number, key: (i: number) => string) => {
        let start = 0;
        for (let i = 1; i <= len; i++) {
            if (i < len && at(i) >= 0 && at(i) === at(start)) continue;
            if (i - start >= min && at(start) >= 0) for (let k = start; k < i; k++) out.add(key(k));
            start = i;
        }
    };
    for (let r = 0; r < rows; r++) scan(cols, c => g[r][c], c => `${r},${c}`);
    for (let c = 0; c < cols; c++) scan(rows, r => g[r][c], r => `${r},${c}`);
    return out;
}
// tests/MatchFinder.test.ts
import { findMatches } from '../assets/scripts/core/MatchFinder';

const sorted = (s: Set<string>) => [...s].sort();

describe('findMatches', () => {
    it('tìm hàng ngang 3 ô', () => {
        expect(sorted(findMatches([[1, 1, 1, 2], [3, 4, 5, 6]]))).toEqual(['0,0', '0,1', '0,2']);
    });
    it('tìm cột dọc 3 ô', () => {
        expect(sorted(findMatches([[2], [2], [2], [5]]))).toEqual(['0,0', '1,0', '2,0']);
    });
    it('hình chữ L tính cả hai nhánh, ô góc không trùng', () => {
        const g = [[7, 7, 7], [7, 0, 1], [7, 2, 3]];
        expect(findMatches(g).size).toBe(5);
    });
    it('bỏ qua ô trống', () => {
        expect(findMatches([[-1, -1, -1]]).size).toBe(0);
    });
    it('chỉ 2 ô thì không ăn', () => {
        expect(findMatches([[4, 4, 1]]).size).toBe(0);
    });
});
// jest.config.js (đặt ở thư mục gốc project, test nằm ngoài assets/ để editor không nạp)
module.exports = {
  preset: 'ts-jest',
  testEnvironment: 'node',
  roots: ['<rootDir>/tests'],
  moduleNameMapper: { '^cc$': '<rootDir>/tests/mocks/cc.ts' },   // nếu lỡ cần 'cc', trỏ tới bản giả tối thiểu
};
// cài: npm i -D jest ts-jest @types/jest typescript   ·   chạy: npx jest

🟡 Ngẫu nhiên có seed và service giả

// RNG tất định: cùng seed → cùng chuỗi số → test và tái hiện lỗi được
export function mulberry32(seed: number) {
    return function next(): number {
        let t = (seed += 0x6D2B79F5);
        t = Math.imul(t ^ (t >>> 15), t | 1);
        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
    };
}

// Logic nhận RNG qua tham số thay vì gọi Math.random() trực tiếp
export function rollReward(rng: () => number, table: { id: string; weight: number }[]) {
    const total = table.reduce((s, x) => s + x.weight, 0);
    let r = rng() * total;
    for (const x of table) { if ((r -= x.weight) < 0) return x.id; }
    return table[table.length - 1].id;
}

// Test phân phối: 100.000 lần với seed cố định, tỷ lệ gần trọng số (sai số cho phép)
it('tỷ lệ rơi đồ khớp bảng', () => {
    const rng = mulberry32(42), table = [{ id: 'common', weight: 90 }, { id: 'epic', weight: 10 }];
    let epic = 0; for (let i = 0; i < 100000; i++) if (rollReward(rng, table) === 'epic') epic++;
    expect(epic / 100000).toBeGreaterThan(0.095); expect(epic / 100000).toBeLessThan(0.105);
});

Service giả (module 6): MockAdService trả về 'rewarded' ngay để test luồng nhận thưởng; MemorySaveService lưu trong RAM để test migrate.

🟡 GoogleTest cho C++

// tests/economy_test.cpp
#include <gtest/gtest.h>
#include "core/Economy.h"

TEST(Economy, KhongDuXuThiKhongMuaDuoc) {
    Economy eco(100);
    EXPECT_FALSE(eco.tryBuy(150));
    EXPECT_EQ(eco.coins(), 100);
}
TEST(Economy, MuaThanhCongTruDungSoXu) {
    Economy eco(100);
    ASSERT_TRUE(eco.tryBuy(40));
    EXPECT_EQ(eco.coins(), 60);
}
# CMakeLists.txt cho bộ test logic thuần (tách khỏi target game)
cmake_minimum_required(VERSION 3.16)
project(core_tests CXX)
set(CMAKE_CXX_STANDARD 17)
include(FetchContent)
FetchContent_Declare(googletest URL https://github.com/google/googletest/archive/refs/tags/v1.14.0.zip)
FetchContent_MakeAvailable(googletest)
enable_testing()
add_executable(core_tests tests/economy_test.cpp src/core/Economy.cpp)
target_include_directories(core_tests PRIVATE src)
target_link_libraries(core_tests GTest::gtest_main)
include(GoogleTest)
gtest_discover_tests(core_tests)
# build & chạy: cmake -S . -B build && cmake --build build && ctest --test-dir build

🟢 CI, phân tích tĩnh, crash

# .github/workflows/ci.yml — chạy test + lint cho mỗi pull request
name: ci
on: [pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 20 }
      - run: npm ci
      - run: npx eslint "assets/scripts/**/*.ts"
      - run: npx jest --ci
Công cụBắt được
typescript-eslintPromise không await, any, biến không dùng, so sánh lỏng
clang-tidy, cảnh báo trình biên dịchLỗi C++ phổ biến, hiện đại hoá code
Firebase Crashlytics (hoặc Sentry)Crash thật trên thiết bị người dùng, gom nhóm theo stack
Upload symbol: dSYM (iOS), NDK symbol (Android)Stack trace native đọc được (tên hàm, dòng) thay vì địa chỉ
Smoke test tự động trên thiết bị (Airtest, Appium, script tự viết)Mở game, vào màn đầu, không crash — chạy cho mỗi bản build
Mục tiêu thực tế

Không cần phủ toàn bộ. Bắt đầu với 20–30 test cho luật chơi, kinh tế, lưu game, so sánh phiên bản; chạy trong CI dưới một phút. Mỗi lỗi logic sửa xong thêm một test để không tái phát.

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

🎤 Game logic nào bạn nhất định viết unit test?
Luật chơi cốt lõi, kinh tế (giá, phần thưởng, giới hạn), lưu game và migrate, so sánh phiên bản/ manifest hot update, FSM luồng game, công thức sát thương/ điểm. Không unit test UI/ animation, thay bằng checklist test tay/ ảnh chụp.
🎤 Làm sao test logic có ngẫu nhiên?
Tiêm RNG có seed thay vì Math.random; test giá trị cụ thể với seed cố định, test phân phối với nhiều lần lặp và sai số cho phép; ghi seed vào log để tái hiện lỗi người chơi.
🎤 Code gameplay gắn chặt Component, làm sao bắt đầu viết test?
Tách dần: rút logic thuần ra module không import engine (refactor nhỏ, có test bao quanh hành vi hiện tại), Component chỉ chuyển input/ output. Ưu tiên phần hay lỗi và đắt nhất.
🎤 Crash native trên Android mà stack chỉ toàn địa chỉ. Bạn làm gì?
Upload symbol của thư viện native (bản chưa strip) lên Crashlytics/ dùng ndk-stack, addr2line để symbolicate; kiểm tra ABI/ build id khớp. Đưa bước upload symbol vào pipeline build.

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

❌ Logic gọi Math.random/ Date.now trực tiếp

Vì sao nguy hiểm: Test không tất định.

Cách làm đúng: Tiêm RNG/ đồng hồ.

❌ Đặt test trong assets/

Vì sao nguy hiểm: Editor nạp file test, lỗi build.

Cách làm đúng: Thư mục tests/ ngoài assets.

❌ Test UI chi tiết bằng unit test

Vì sao nguy hiểm: Mong manh, tốn công.

Cách làm đúng: Unit test logic; UI test bằng checklist/ smoke.

❌ CI chạy test quá lâu

Vì sao nguy hiểm: Mọi người bỏ qua CI.

Cách làm đúng: Bộ test nhanh dưới 1 phút; test chậm chạy định kỳ.

❌ Không upload symbol

Vì sao nguy hiểm: Crash native không đọc được.

Cách làm đúng: Tự động hoá trong pipeline.

📌 Cần nhớ
  • Test logic quan trọng: luật chơi, kinh tế, lưu game, phiên bản, FSM.
  • Logic thuần không import engine; RNG/ service tiêm vào.
  • Jest cho TS, GoogleTest + CMake cho C++.
  • CI chạy lint + test mỗi PR.
  • Crashlytics + upload symbol cho crash native.

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

1. Để logic match-3 test được bằng Jest, nó nên:
A. Import Node từ 'cc'
B. Là module thuần không phụ thuộc engine
C. Nằm trong prefab
Đáp án: B. Chạy trên Node.js.
2. Test có ngẫu nhiên tất định bằng cách:
A. Chạy nhiều lần cầu may
B. Dùng RNG có seed tiêm vào
C. Tắt ngẫu nhiên trong game
Đáp án: B. Tái lập được.
3. compareVersion('1.10.0', '1.9.9') nên trả về:
A. Âm
B. Dương
C. 0
Đáp án: B. So từng phần số, 10 > 9.
4. Stack trace crash native chỉ có địa chỉ: thiếu bước:
A. Upload symbol
B. Thêm log
C. Đổi engine
Đáp án: A. Cần symbol để đọc.
5. Thứ KHÔNG nên viết unit test chi tiết:
A. Công thức phần thưởng
B. Vị trí pixel của nút trên popup
C. Migrate bản lưu
Đáp án: B. UI mong manh.

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

Bộ test cho “critical game logic”

Viết 20 test Jest cho: findMatches, rollReward với seed, Economy (mua/ thưởng/ giới hạn), migrate bản lưu v1→v2, compareVersion cho hot update. Đưa vào GitHub Actions; cố ý làm hỏng một test để thấy PR bị chặn.

💡 Gợi ý lời giải
compareVersion: tách theo dấu chấm, so từng phần dạng số, thiếu phần coi là 0; test các ca 1.10.0 vs 1.9.9, 1.0 vs 1.0.0, 2.0.0-beta (quyết định quy ước và ghi rõ). Đây cũng là hàm bạn sẽ dùng thật ở module 17.

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

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

  • Liệt kê logic quan trọng của game bạn
  • Viết findMatches + test
  • RNG có seed
  • GoogleTest với CMake
  • CI chạy lint + test
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.