简介一套适合Android入门者与游戏开发爱好者学习参考的中国象棋项目源码。项目完整实现了棋盘绘制、走棋规则、人机对战与双人对战等核心功能代码中涉及自定义视图、触摸事件、数据结构与搜索算法如极大极小值思想并配有菜单、帮助等界面模块适合用来理解Android游戏从界面到逻辑的完整开发流程。压缩包共一百一十一个文件以六十六张棋子棋盘图片、十个源码文件、二十个编译类文件为主另含三个音频、布局与配置文件以及可直接安装的安装包和调试文件整体仅4.44MB结构紧凑清晰。已有两百八十五人学习下载。通过学习这份源码可同时掌握Android布局设计、自定义控件绘制、文件读写与多线程处理等知识点还能借鉴人机对战的算法思路为后续开发自己的棋类或回合制游戏打下基础。资源体积小、代码量适中尤其适合在真机上边读边改快速上手实践。1. 为什么 Android 中国象棋源码比五子棋、连连看更适合拆解很多开发者找源码练手时第一反应是选一个“看着简单”的游戏比如五子棋或者井字棋。Android 中国象棋源码的线性复杂度其实比它们更友好棋盘固定 10 行 9 列棋子只有 7 种所有走法都能用坐标差列出来不用像围棋那样考虑打劫和提子的全局关系。但它的难度又足以逼你处理“拐马脚”“塞象眼”“将帅不能见面”这类边界规则还要在 AI 搜索里控制时间不然用户走一步等 10 秒直接卸载。这类项目对入门者有用的地方在于UI、状态、算法三层耦合得很清晰可以从一个 onDraw 方法一路找到 alpha-beta 剪枝。对有五年以上经验的工程师来说读这种代码能快速捡起事件分发、自定义 View 性能、时间片分配这些基本功改起来比全新写一个完整项目更快上手。下面按“跑通 → 拆代码 → 调参数 → 验证”的顺序展开。2. 在 Android Studio 里把 Android 象棋源码跑通的最小步骤拿到一套 Android 中国象棋源码后先别急着读 MainActivity而是先确认它能不能在 Android Studio 里同步通过。这类老项目最常见的三个“环境杀手”是 Gradle 版本过旧、SDK Platform 缺失、JDK 不匹配任何一个不解决后面所有改造都是纸上谈兵。我一般会先把根目录打开看一眼再决定怎么调整。2.1 先确认根目录是项目根还是模块根把源码解压后不要直接双击.java文件。用命令先看目录unzip chinesechess-android.zip cd chinesechess-android ls -la如果看到settings.gradle和build.gradle在同一层这里是项目根。如果目录里面还有一个app/通常模块根在app/下。用 Android Studio 导入时选项目根也就是含settings.gradle的那一层。选错层级会看到 “Gradle project sync failed”因为 Android Studio 找不到可构建的工程。常见项目的目录结构大致如下目录/文件作用app/build.gradle模块级构建配置最常改的地方gradle/wrapper/gradle-wrapper.properties固定 Gradle 版本避免换机后编译行为漂移local.properties本机 Android SDK 路径由 Android Studio 自己生成app/src/main/jniLibs/如果走法引擎用 C/C 实现这里放 so 动态库local.properties不要提交到版本库它绑定了本机路径。命令行导入时没有这个文件会导致SDK location not found在 Android Studio 里同步一次会自动生成也可以手动写一行sdk.dirC\:\\Android\\Sdk注意 Windows 路径里的反斜杠在 properties 文件里要转义写\\而不是\否则sdk.dir解析到错误路径。Mac/Linux 直接用/Users/you/Library/Android/sdk这样的路径。2.2 同步前先统一 SDK、Gradle 和 JDK 三个版本很多源码发布时用的 compileSdk 可能是 28而现在 Android Studio 默认环境可能只有 34 的 SDK。同步时可以临时改compileSdk和targetSdkandroid { compileSdk 34 defaultConfig { applicationId com.example.chinesechess minSdk 21 targetSdk 34 versionCode 1 versionName 1.0 } compileOptions { sourceCompatibility JavaVersion.VERSION_17 targetCompatibility JavaVersion.VERSION_17 } }compileSdk 34只是编译期 API 版本不一定需要 Android 14 的系统运行minSdk 21表示支持 Android 5.0 及以上targetSdk 34会触发较新的运行时行为比如 Android 13 之后的通知权限。如果源码没有适配这些行为反而应该把targetSdk保持原来的值而不是盲目升到最新。compileOptions中的 Java 17 要和当前 Android Studio 用的 JDK 对应否则会报invokedynamic requires ASM或 source/target 错误。Gradle 版本在gradle/wrapper/gradle-wrapper.properties里最简单的方式是改成你熟悉的版本distributionUrlhttps\://services.gradle.org/distributions/gradle-8.4-bin.zip但注意 Gradle 8.4 要求 AGPAndroid Gradle Plugin版本不能太低一般是 8.2 以上。如果源码的build.gradle里写的 AGP 是 4.0.2反而要把 Gradle 版本降到 6.x。最稳的做法是保持源码自带的 wrapper 版本只改 JDK 和 SDK先让它原样编译。2.3 三个高频报错和对应处理报错片段原因处理SDK location not found.缺少local.properties在项目根创建文件并写入 SDK 路径Could not find com.android.tools.build:gradle没有配置 google() 仓库打开顶层build.gradle确认 repositories 里有google()Source option 8 is no longer supportedJDK 17 下编译级别太低把compileOptions的 sourceCompatibility 改成 17 或 11Manifest merger failed第三方依赖的最低 targetSdk 高于项目设置把 targetSdk 提到依赖要求的级别或升级依赖遇到Manifest merger failed时先看 Gradle Console 里具体冲突的是哪两个库优先升级旧库而不是降级其他库。象棋源码一般没有复杂依赖最多一个广告 SDK 和一个回调库冲突概率不大。注意不要同时升级 Gradle 和 AGP。老代码一次只动一个变量否则报错时很难判断是哪个变化引起的。把这几个环境问题清完后跑通第一个界面大概只需要一个模拟器。模拟器选 API 21 到 30 之间的系统镜像都可以太高有时反而暴露原源码对旧 API 的兼容问题。3. 从棋盘到 AI拆解 Android 中国象棋源码的核心模块当项目能跑起来后再看代码就有底气了。Android 中国象棋源码通常分成三块用自定义 View 画的 UI、用二维数组存的棋盘状态、用搜索算法跑的 AI 引擎。这里按数据流动顺序拆开。3.1 棋盘状态用二维数组和正负号区分红黑绝大多数象棋源码不会为每个棋子设计一个类而是用int[10][9]配合编码表。我见过最省事的一套编码是棋子红方编码黑方编码帅/将4-4车1-1马2-2炮3-3士5-5象6-6兵/卒7-7public class ChessBoard { private int[][] board new int[10][9]; public int getPiece(int row, int col) { return board[row][col]; } public boolean isRed(int row, int col) { return board[row][col] 0; } public boolean isBlack(int row, int col) { return board[row][col] 0; } }正负号方案的好处是不需要再保存一个“当前阵营”的额外标记isRedTurn配合行号就能判断移动方向。棋盘行号从 0 到 9从上往下是黑方从下往上是红方。isRed这样写时空子返回 false所以后续调用都要先判断getPiece ! 0。3.2 自定义 ViewonDraw 画棋盘onTouchEvent 算坐标象棋 UI 的核心不是一大堆布局文件而是一个继承View的棋盘控件。这里要关注两点测量时保证格子是正方形触摸时把像素坐标转换成行列号public class ChessBoardView extends View { private int cellSize; private ChessBoard board; public ChessBoardView(Context context, AttributeSet attrs) { super(context, attrs); } Override protected void onSizeChanged(int w, int h, int oldw, int oldh) { super.onSizeChanged(w, h, oldw, oldh); cellSize Math.min(w / 9, h / 10); } Override protected void onDraw(Canvas canvas) { drawGrid(canvas); drawPieces(canvas); } Override public boolean onTouchEvent(MotionEvent event) { if (event.getAction() MotionEvent.ACTION_UP) { int col (int) (event.getX() / cellSize); int row (int) (event.getY() / cellSize); if (row 0 row 10 col 0 col 9) { listener.onCellTap(row, col); } } return true; } }onSizeChanged里用宽高分别除以 9 和 10再取最小值保证 9 列和 10 行都能完整显示同时避免棋盘被拉伸。如果没有加padding触摸事件落在棋盘边缘时按整数除法会得到 0 或者 8因此触摸映射通常要留出boardMargin常见的做法是先减掉边距再除格子尺寸。onTouchEvent返回 true 而不是 super表示消费掉整段触摸事件不会再把 ACTION_UP 交给父容器处理否则在 ScrollView 里使用棋盘时会滑动冲突。网格绘制部分不必每次 onDraw 都 new Paint把Paint声明成成员变量并在初始化时配置好避免绘制路径里频繁创建对象导致 GC。这个点在onDraw里尤其明显因为动画和悔棋都会触发重绘。3.3 走法生成马的蹩腿和炮的跳吃最容易写错走法生成决定 AI 能看到哪些分支也决定用户点击某个子时高亮哪些落点。象棋里最容易写错的两个走法是马和炮。马走“日”字但马腿位置和移动方向强相关private void addHorseMoves(int r, int c, int[][] board, ListMove moves) { int[][] moveOffsets {{-2, -1}, {-2, 1}, {2, -1}, {2, 1}, {-1, -2}, {1, -2}, {-1, 2}, {1, 2}}; int[][] legOffsets {{-1, 0}, {-1, 0}, {1, 0}, {1, 0}, { 0, -1}, {0, -1}, { 0, 1}, { 0, 1}}; for (int i 0; i moveOffsets.length; i) { int nr r moveOffsets[i][0]; int nc c moveOffsets[i][1]; int hr r legOffsets[i][0]; int hc c legOffsets[i][1]; if (!isInBoard(nr, nc)) continue; if (board[hr][hc] ! 0) continue; if (!isSameSide(board[r][c], board[nr][nc])) { moves.add(new Move(r, c, nr, nc)); } } }legOffsets数组是每个移动方向对应的马腿坐标偏移。注意moveOffsets里(-2,-1)和(-2,1)的马腿坐标相同都是在(-1,0)所以数组里这两个位置的值相同。相同的位置写两次是正常的不是笔误。isSameSide检查目标格是空子还是敌子自己的棋子不能吃空子和敌方棋子才能走。炮的走法分两步先是水平或垂直直行遇到第一个炮架后继续往前走找第一个棋子作为目标吃子时必须隔一个炮架不吃子时路径上不能有任何棋子。用一个 for 循环向四个方向延伸维护一个hasScreen标志位即可。许多老版本源码会在“翻山”条件里漏掉captured 0的情况导致炮吃不了子或者隔着两个子也能吃。3.4 AI 搜索alpha-beta 剪枝比直接 DFS 快一个量级AI 的本质是在走法树里搜索最佳着法。如果不剪枝深度 4 时平均每步 40 种走法节点数大概在 40^4 即 256 万实际加上吃子检查会更多。alpha-beta 剪枝可以把有效节点压到约 7 万左右这就是为什么象棋源码里都用它而不是简单极大极小。int alphaBeta(int depth, int alpha, int beta, boolean redTurn) { if (depth 0) { return evaluate(); } ListMove moves generateMoves(redTurn); if (moves.isEmpty()) { return redTurn ? Integer.MIN_VALUE 1 : Integer.MAX_VALUE - 1; } if (redTurn) { int best Integer.MIN_VALUE; for (Move move : moves) { applyMove(move); best Math.max(best, alphaBeta(depth - 1, alpha, beta, false)); undoMove(move); alpha Math.max(alpha, best); if (beta alpha) { break; } } return best; } else { int best Integer.MAX_VALUE; for (Move move : moves) { applyMove(move); best Math.min(best, alphaBeta(depth - 1, alpha, beta, true)); undoMove(move); beta Math.min(beta, best); if (beta alpha) { break; } } return best; } }alpha初始为Integer.MIN_VALUEbeta初始为Integer.MAX_VALUE。对红方来说每次发现自己打分比当前 alpha 高就更新下界对黑方则更新上界。一旦上层已知 best 超过了下层的 beta下面这个子树永远不会被上层选择可以提前返回。if (moves.isEmpty())这行处理“被将死”的情况把直接分值设为±(无穷大-1)而不是±无穷大是因为后续搜索里可能还要做乘法或加法避免越界。剪枝效率特别依赖走法排序顺序。源码里常见的是先搜索吃子走法中的高价值目标比如车让 beta 尽早变小红方的 alpha 尽早变大。如果走法列表是随机的剪枝率会显著降低同样的深度下响应时间差出一倍以上。评估函数也不在搜索里贴一大堆 if而是把棋子价值和位置表算好。常见权重如下棋子基础价值位置加成建议将/帅10000无车900河界后略加分马400中心格 10边角 -30炮400有架时 5无架时 -5士/象200只能在九宫/己方兵/卒100过河后 20这个表不是绝对标准但“将帅权重高到无法用车换”是必须保证的。马和炮都设为 400符合“马炮基本等值”的传统棋力。位置加成可以用一个int[10][9]数组按行列查表即可。4. 改难度、悔棋与包名Android 中国象棋源码的 4 个必调参数运行正常后大部分人想做的第一件事就是换掉默认设置。下面按源码里常见的关键位置展开不一定每个项目都在同名文件里但搜索关键词是一致的。4.1 AI 深度和思考时间的平衡private static final int MAX_DEPTH 4; private static final long THINK_TIME_LIMIT_MS 800; private Move iterativeDeepening(boolean redTurn) { long deadline System.currentTimeMillis() THINK_TIME_LIMIT_MS; Move bestMove null; for (int depth 1; depth MAX_DEPTH; depth) { int score alphaBetaWithMove(depth, Integer.MIN_VALUE, Integer.MAX_VALUE, redTurn, bestMove); bestMove lastBestMove; if (System.currentTimeMillis() deadline) { break; } } return bestMove; }alphaBetaWithMove就是在前面搜索函数基础上把当前层的best对应的move记到lastBestMove上其他逻辑不变。这个循环从深度 1 开始一方面保证时间用完时至少有一步棋另一方面上一次的bestMove可以作为下一次搜索的“期望走法”帮助走法排序。MAX_DEPTH与THINK_TIME_LIMIT_MS哪个先触发是判断难度的关键低端机上 800ms 可能只能跑到深度 2高端机上可以跑完深度 4本质上是用时间换深度。如果只是想简单调难度直接把MAX_DEPTH从 2 改成 4 即可。改成 6 之前先确认评估函数很稳定否则深度增加后 AI 会为了“保持局势”走出重复绕步给人一种拿着优势局面主动和棋的错觉。4.2 位置表和子力分值的微调private int evaluate(int[][] board) { int score 0; for (int r 0; r 10; r) { for (int c 0; c 9; c) { int p board[r][c]; if (p 0) continue; int v Math.abs(p); int pieceScore baseValue(v); if (p 0) { score pieceScore positionBonus(v, r, c, true); } else { score - pieceScore positionBonus(v, 9 - r, c, false); } } } return score; }9 - r是为了让黑方的坐标转成以红色视角看的位置表黑方位置表不用另写一份。positionBonus的典型逻辑是车在开放线加 10、马在中心加 10、兵过河加 15。注意过河判断要区分红黑红兵row 4黑卒row 5不同源码的初始行号定义可能差 1要先画一个棋盘打印行号验证。4.3 悔棋逻辑需要保存被吃子private final DequeMove undoStack new ArrayDeque(); private void applyMove(Move move) { move.capturedPiece board[move.toR][move.toC]; board[move.toR][move.toC] board[move.fromR][move.fromC]; board[move.fromR][move.fromC] 0; undoStack.push(move); } private void undo() { Move move undoStack.pop(); board[move.fromR][move.fromC] board[move.toR][move.toC]; board[move.toR][move.toC] move.capturedPiece; boardView.invalidate(); }move.capturedPiece这一步必须在覆盖目标格前保存否则悔棋后棋盘上会凭空消失一个子。同理AI 搜索里的applyMove和全局悔棋用的applyMove必须是同一套实现很多人看着能走棋但没法悔棋就是因为搜索时临时缓存的状态没有走到同一个栈里。undoStack只保存走子不保存“红方走完黑方走”的回合标志如果源码里用isRedTurn作全局变量悔棋时还要把它翻转回去。Move至少要保存 fromR、fromC、toR、toC 和 capturedPiece 五个字段。4.4 改应用名和 applicationId 避免冲突defaultConfig { applicationId com.yourname.chinesechess resValue string, app_name, 中国象棋 }applicationId改完会生成一个新的应用签名身份不会被原包覆盖。resValue可以覆盖字符串资源但更容易直接改app/src/main/res/values/strings.xml中的app_name。注意一些老源码会在AndroidManifest.xml里写android:labelChessManifest 里的优先级高于 strings.xml所以两个地方都要改。注意如果源码里还引用了广告 SDK 或统计库换包名后需要在build.gradle的 dependencies 里同步清理相关依赖否则 Manifest merger 会再次失败。5. 用 FEN、日志与残局验证 Android 中国象棋源码的棋力改完参数后最忌讳只靠“模拟器里随便下几步”判断效果。AI 走错一步可能隐藏十几个 bug。我一般会用三个方法交叉验证导出一盘棋的 FEN、打印每步搜索耗时、用固定残局做回归。5.1 把棋盘状态导出成 FEN 串public String toFen() { StringBuilder fen new StringBuilder(); for (int r 0; r 10; r) { int empty 0; for (int c 0; c 9; c) { int p board[r][c]; if (p 0) { empty; continue; } if (empty 0) { fen.append(empty); empty 0; } fen.append(pieceChar(p)); } if (empty 0) fen.append(empty); if (r 9) fen.append(/); } fen.append( w - - 0 1); return fen.toString(); }pieceChar把红子映射到大写字母、黑子映射到小写字母比如车是R/r马是H/h。这样导出后可以复制到其他支持中国象棋 FEN 的工具里对照局面验证走子后棋子是否落到正确位置。要注意empty在每行结束时需要补一次否则空格的数字会少一段。5.2 用 Log 输出搜索耗时和深度long start System.nanoTime(); Move move engine.iterativeDeepening(isRedTurn); long costMs TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - start); Log.d(ChessAI, best move costMs costMs depthReached engine.lastSearchDepth);lastSearchDepth是迭代加深中实际跑到的最大深度。正常情况 costMs 稳定在设定时间附近如果远小于设定时间说明深度循环因为MAX_DEPTH提前结束如果远大于设定时间要检查是不是在alphaBeta里做了额外的高成本工作比如频繁创建ListMove导致 GC 压力。5.3 固定残局做回归测试建议用三个残局双车对士象全正常必须能赢单车对单将深度 3 以上能形成杀势单马对单士深度 4 时能走出“七步擒士”的关键路线。把这三个棋局初始化为数组或 FEN跑一遍 AI 的自动对弈记录结果。如果其中一步棋出现吃子后仍和棋的异常优先检查评估函数里的“是否被将死”分支而不是去调搜索深度。这套回归比坐在模拟器里手动走棋要快很多也是把改动从“能跑”推向“能用”的关键一步。本文还有配套的精品资源点击获取