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.
- “Write unit tests for critical game logic”
- “Nice to have: Experience with automated testing and unit-test frameworks”
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ì?
| Logic | Vì sao quan trọng | Ví dụ test |
|---|---|---|
| Luật chơi (match, gravity, combo) | Lỗi là game sai, người chơi kẹt màn | Bà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 ảo | Không đủ xu thì không mua được, số dư không đổi |
| Lưu game & migrate | Lỗi là mất tiến trình người chơi | Bản lưu v1 → v2 đúng trường |
| So sánh phiên bản hot update | Lỗi là không cập nhật hoặc cập nhật vòng lặp | 1.10.0 > 1.9.9 |
| FSM luồng game | Lỗi là kẹt trạng thái | Chuyển không hợp lệ phải báo lỗi |
| Không nên unit test | Bố cục UI, animation, shader | Kiể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-eslint | Promise 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ịch | Lỗ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 |
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?
🎤 Làm sao test logic có ngẫu nhiên?
🎤 Code gameplay gắn chặt Component, làm sao bắt đầu viết test?
🎤 Crash native trên Android mà stack chỉ toàn địa chỉ. Bạn làm gì?
⚠️ Sai lầm thường mắc
Vì sao nguy hiểm: Test không tất định.
Cách làm đúng: Tiêm RNG/ đồng hồ.
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.
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.
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ỳ.
Vì sao nguy hiểm: Crash native không đọc được.
Cách làm đúng: Tự động hoá trong pipeline.
- 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
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
3. compareVersion('1.10.0', '1.9.9') nên trả về:
A. Âm
B. Dương
C. 0
4. Stack trace crash native chỉ có địa chỉ: thiếu bước:
A. Upload symbol
B. Thêm log
C. Đổi engine
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
🏋️ Bài tập thực hành
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
📚 Tài nguyên học tập
- Jest: Getting StartedCài đặt, matcher, mockTài liệu
- GoogleTest User's GuideTest C++ với CMakeTài liệu
- Firebase CrashlyticsBáo cáo crash, symbol nativeTài liệu
✅ 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