简介基于Android Studio 4.0.1开发的五子棋对战小游戏项目面向安卓开发学习者与计算机专业课程设计人群。项目提供人机对战和人人对战两种玩法人机模式支持单人挑战AI系统根据棋盘各落子点的得分评估自动决策并实时记录比赛得分人人对战由双方轮流下棋自动标记当前棋子颜色对局中可随时开始新游戏或悔棋主界面还能设置背景音乐开关、查看游戏介绍交互完整且易上手。资源压缩包共包含657个文件以Java源码、XML布局、Gradle配置、APK安装包及部分编译中间产物为主Java与XML文件分别承担业务逻辑和界面展示Gradle脚本负责构建流程APK可直接安装体验便于从源码到产物完整理解Android开发链路压缩包整体约30.71MB。目前已有2092人学习下载。整套实现涵盖棋盘绘制、落子判定、AI决策、悔棋逻辑与背景音乐控制等完整模块既能满足计科学生完成安卓课程设计的需要也可供希望深入理解Android自定义View、事件处理与基础算法设计的开发者参考并在此基础上进行功能扩展与二次修改。1. Android Studio 五子棋小游戏一个能写进课设的完整安卓项目先说结论这份资源不是那种只有几百行代码、跑起来就闪退的 Demo而是一个能在 Android Studio 里直接打开、编译、安装到真机或模拟器上的完整五子棋 App。它覆盖了自定义 View 绘制棋盘、双人对战逻辑、胜负判定、落子音效、悔棋、重新开始这些功能正好卡在安卓课设“不能太简单、又不能太复杂”的区间上。计科专业做移动应用开发课设拿它当底子改一改比从零写要稳妥得多。我拆过不下几十个安卓课设资源这个项目的价值在于棋盘和棋子是用自定义 View 画的不是贴图这意味着你能在代码里看到 Canvas、Paint、OnTouchEvent 这些核心 API 的真实用法而不是被一堆 Fragment 和 RecyclerView 糊弄过去。适合正在学安卓开发、需要交课设、或者想搞明白自定义控件到底怎么回事的人。2. 项目结构与核心机制先把代码骨架摸清楚2.1 工程文件长什么样拿到项目后先在 Android Studio 里打开等 Gradle 同步完成。这个项目是标准的 Android 工程结构主代码都在app/src/main/java下面布局文件在res/layout资源文件在res/drawable和res/menu。先别急着点 Run把文件结构看一遍心里要有一张地图。一个典型的五子棋项目最少包含以下核心文件文件作用MainActivity.java入口 Activity负责加载布局、初始化棋盘、处理菜单事件GobangView.java核心自定义 View画棋盘、画棋子、处理触摸、判断胜负activity_main.xml主布局放置 GobangView 和底部按钮menu_main.xml菜单栏包含重新开始、悔棋等动作drawable/存放棋子、棋盘背景等图片资源values/strings.xml所有字符串资源方便后期替换打开MainActivity.java你会发现它做的事并不多setContentView加载布局拿到GobangView引用然后处理菜单点击。真正的游戏逻辑全在GobangView里这也是安卓自定义控件开发的典型范式——把需要频繁重绘的界面放进自定义 View用invalidate()触发重绘而不是依赖布局文件里堆组件。2.2 棋盘绘制的底层逻辑五子棋棋盘是 15×15 的网格绘制时要处理三件事画线、画棋子、处理落子位置。GobangView里有一段初始化代码核心是把屏幕尺寸算好让棋盘居中并留出边距Override protected void onSizeChanged(int w, int h, int oldw, int oldh) { super.onSizeChanged(w, h, oldw, oldh); // 棋盘宽度取屏幕宽和高中的较小值保证横竖屏都能完整显示 mBoardWidth Math.min(w, h); // 每个格子的边长 棋盘宽度 / 1415条线之间只有14个间隔 mCellSize mBoardWidth / 14.0f; // 棋盘起点往左上角偏移让整个棋盘在屏幕中央留出上下空间放落子 mOffsetX (w - mBoardWidth) / 2.0f; mOffsetY (h - mBoardWidth) / 2.0f; initGameData(); }这段代码里有几个关键点。onSizeChanged是 View 尺寸确定后的回调在这里拿到实际的屏幕宽高然后算出棋盘宽度、格子和偏移量。mBoardWidth取w和h的较小值是为了让棋盘是正方形——五子棋棋盘必须是 15×15 的正方形网格如果直接拿w当棋盘宽竖屏时棋盘会超出屏幕底部。mCellSize的计算用的是14而不是15因为 15 条线之间只有 14 个间隔这个细节很多人第一次写会搞错导致棋盘最后一条线画到屏幕外。绘制棋盘线时用Canvas.drawLine逐条画横竖各 15 条。画棋子时根据mBoard[i][j]数组的值判断0 表示空1 表示黑棋-1 表示白棋然后canvas.drawCircle画圆。每次触摸落子后调用invalidate()系统就会重新走一遍onDraw。2.3 落子与悔棋的实现方式GobangView的触摸事件是核心它通过onTouchEvent判断用户点击的位置然后把坐标换算成棋盘索引Override public boolean onTouchEvent(MotionEvent event) { if (mGameOver) { return super.onTouchEvent(event); } if (event.getAction() MotionEvent.ACTION_DOWN) { // 把触摸坐标减去偏移量再除以格子大小得到第几行第几列 float x event.getX() - mOffsetX; float y event.getY() - mOffsetY; int row (int) (y / mCellSize); int col (int) (x / mCellSize); if (row 0 row 15 col 0 col 15) { putPiece(row, col); } return true; } return super.onTouchEvent(event); }putPiece方法里会先检查当前交叉点上是否已有棋子没有则落子落子后把当前回合切换到对手再检查胜负最后invalidate()刷新界面。这里要注意屏幕坐标和棋盘坐标的换算event.getX()返回的是相对于 View 左上角的绝对坐标而棋盘可能因为屏幕比例和边距并没有从 View 左上角开始所以要先减mOffsetX和mOffsetY再做除法。很多人第一次写触摸棋盘棋子总是落在触摸点偏右下方向就是因为漏了偏移量换算。悔棋的逻辑也不是简单地把最后一个棋子置空。项目里用了一个栈Stackint[]来记录每一步的落子位置悔棋时从栈顶弹出上一个坐标把这个位置的棋盘数组值恢复为 0然后切换回合。这个栈同时负责回放——虽然这个项目没做回放功能但保留了栈结构你后续想加回放就很方便。3. 胜负判定与回合管理看懂这段代码就能举一反三3.1 五连子判定算法胜负判定是五子棋最核心的逻辑。常见做法是在每次落子后从当前落子点向四个方向水平、垂直、主对角线、副对角线分别数连子数量任一方向上连子数 ≥ 5 即获胜。GobangView里的判定方法长这样private boolean checkWin(int row, int col) { int currentPlayer mBoard[row][col]; // 四个方向横、竖、主对角线、副对角线 int[][] directions {{0,1}, {1,0}, {1,1}, {1,-1}}; for (int[] dir : directions) { int count 1; // 正方向数 for (int i 1; i 5; i) { int r row dir[0] * i; int c col dir[1] * i; if (r 0 || r 15 || c 0 || c 15 || mBoard[r][c] ! currentPlayer) { break; } count; } // 反方向数 for (int i 1; i 5; i) { int r row - dir[0] * i; int c col - dir[1] * i; if (r 0 || r 15 || c 0 || c 15 || mBoard[r][c] ! currentPlayer) { break; } count; } if (count 5) { return true; } } return false; }这段代码的思路是以落子点为中心向某个方向的正方向数到边界或遇到不同棋子为止再向反方向数把两段数量加起来。大于等于 5 就赢。方向数组{{0,1}, {1,0}, {1,1}, {1,-1}}分别代表水平、垂直、右下对角线、左下对角线前两个分量是行方向的偏移后两个是列方向偏移。注意{1,-1}这个方向是行加一同时列减一从视觉上就是往左下走加上反方向就是往右上走合起来正好覆盖副对角线。边界检查r 0 || r 15不能省。如果不做检查越界访问mBoard会抛出ArrayIndexOutOfBoundsExceptionApp 直接闪退。这个判定方法的时间复杂度是 O(1)因为总共只向四个方向各延伸 4 格跟棋盘大小无关性能上没有任何压力。3.2 回合切换与游戏状态管理mBoard是个int[mBoardSize][mBoardSize]的二维数组mIsBlack true表示当前轮到黑棋。每走一步mIsBlack !mIsBlack。mGameOver标志位在胜利或平局时置为true置位后onTouchEvent直接拦截所有触摸。项目还在onDraw里绘制了“再来一局”的悬浮文字按钮实际上是通过onTouchEvent判断点击区域是否落在按钮范围内实现的。一个值得留意的细节是initGameData方法它在 Activity 重建时会被调用负责把所有状态重置。这对应安卓系统的配置变更问题——手机旋转屏幕时 Activity 会销毁重建如果没有状态恢复机制棋盘就会清零。这个项目用了比较简单的方案把 Activity 的screenOrientation固定为竖屏绕开了旋转问题。如果你想支持横屏就得在onSaveInstanceState里保存棋盘数组或者在AndroidManifest.xml里配置android:configChanges。从这个角度说项目选竖屏锁定是有意为之的课设答辩时能主动说出这一点反而是加分项。3.3 平局判定与死局处理五子棋还有个边界状态棋盘下满但没人五连。项目的处理方式是维护一个落子计数每成功落子一次加一当计数等于 15×15225 时判定平局。平局后mGameOver true但提示文案是“平局”而不是“XX 获胜”。这段逻辑虽然不长却是完整游戏必备的闭环。很多新手项目只处理胜负不处理平局棋盘下满后继续点会数组越界这个坑在评审演示时特别容易翻车。4. 避坑与常见问题编译、运行、适配的实战排查记录4.1 编译环境问题Gradle 版本与 SDK 不匹配现象打开项目后 Gradle 同步失败报错Failed to resolve: com.android.support:support-annotations或者Unable to load class javax.xml.bind.JAXBException。原因项目用的是老版本的 Android Gradle PluginAGP而你本地的 Android Studio 版本较新JDK 版本从 8 升到了 11/17老 AGP 无法解析新 JDK 的模块系统同时compileSdkVersion指定的 SDK 版本本地没装。解决先看build.gradle里的gradle版本和com.android.tools.build:gradle版本。常见做法是直接把 AGP 升到当前 Android Studio 支持的版本比如 8.x然后把compileSdkVersion改成你本地已安装的 API Level。如果项目引用的是老的support库把com.android.support:appcompat-v7替换成新工程的androidx.appcompat:appcompat:1.x.x同时把MainActivity的继承类从Activity改为AppCompatActivity。注意从 support 库迁到 androidx光改依赖不够还要引入androidx.core:core并在 gradle.properties 里加一行android.useAndroidXtrue。4.2 真机运行提示安装失败现象手机连上 USBAndroid Studio 点击 RunBuild 成功后安装报错INSTALL_FAILED_UPDATE_INCOMPATIBLE或INSTALL_FAILED_USER_RESTRICTED。原因前者是因为手机上已经装过同一个包名的 App但签名不同比如之前装的是市场版现在装的是 debug 签名版无法覆盖安装。后者是华为等品牌手机默认开启了“开发人员选项”里的某些限制或者是 MIUI 需要在开发者选项里关闭“USB 安装监控”。解决INSTALL_FAILED_UPDATE_INCOMPATIBLE直接卸载手机上的旧版再安装。INSTALL_FAILED_USER_RESTRICTED去开发者选项里打开“USB 安装”小米还要设置一个锁屏密码才能开启。另外Android 11 及以上系统用 debug 签名安装到真机没问题但如果项目配置了android:testOnlytrue真机安装会直接失败检查 AndroidManifest 里有没有这个属性有就删掉。4.3 棋盘绘制比例不对棋子挤在一起现象在模拟器和真机上棋盘大小不一致真机大屏上棋子偏小棋盘线离屏幕边缘太近或者在横屏状态下棋盘被拉伸变形。原因项目在onSizeChanged里用Math.min(w, h)取边长本意是自适应但你改了AndroidManifest.xml里的screenOrientation或者你的真机屏幕长宽比特殊比如带刘海屏导致mOffsetX和mOffsetY计算结果没有被重新计算。解决改完布局或旋转方向后强制在onLayout里重新计算一遍所有几何参数。我在这个项目中踩过最典型的坑参考了网上一个版本把onSizeChanged里的mBoardWidth Math.min(w, h)改成了mBoardWidth w结果竖屏没问题横屏棋子全部画到屏幕外。后来统一用onSizeChanged里的三元判断并且把棋盘边距算进mOffset里问题解决。顺带说一句五子棋棋子的半径不要硬编码用mCellSize * 0.42这种相对值不同分辨率下才能保持协调。4.4 invalidate 不生效界面不刷新现象点击棋盘时没有任何反应或者棋子出现但一直不消失。原因onTouchEvent里没有调用invalidate()或者刷新线程和 UI 线程冲突。项目本身是单线程触摸事件正常情况下点一下就应该走onDraw。如果你自己加了悔棋按钮但忘了在按钮点击后调invalidate()棋子在画面上不会消失。解决记住一个规律任何改变棋子状态的操作最后必须补一句invalidate()。如果是跨线程操作比如用 Handler 延迟下棋必须通过runOnUiThread或在 View 上直接postInvalidate()否则只能在线程里postInvalidate不能直接调invalidate。这个坑在加“电脑 AI 自动下棋”功能时特别容易出现——你跑一个子线程算棋算完直接改数组不刷新界面就像冻住了一样。4.5 屏幕尺寸适配问题刘海屏和全面屏现象在华为、小米等全面屏手机上棋盘整体偏上或偏下底部按钮被导航栏遮挡。原因Android 默认的沉浸式布局在 18:9 以上的屏幕上有信息区域重叠问题而项目的布局用了固定高度没有考虑系统导航栏和状态栏占位。解决在activity_main.xml里给最外层布局设置android:fitsSystemWindowstrue或者用ConstraintLayout把棋盘约束到居中底部按钮约束到棋盘下方而不是从屏幕底往上推。真机上有老项目的通用做法在 AndroidManifest 里给 Activity 加android:windowSoftInputModeadjustResize但这治标不治本。我自己的习惯是拿到任何课设项目先跑一遍不同分辨率的模拟器专门检查键盘弹起和底部导航栏遮挡这一步能避免答辩时被老师当场发现适配问题。4.6 重启 Activity 后棋盘数据丢失现象按 Home 键切后台再回 App棋盘还在但转屏后棋盘全空或者切到多任务再回来偶尔会白屏。原因这个项目固定竖屏转屏问题被绕开了。但如果你改成支持横屏系统默认会销毁 Activity 重建而mBoard数组是成员变量重建后所有数据归零。解决让 Activity 实现onSaveInstanceState把二维数组序列化到 Bundle 里在onCreate里恢复。代码大概长这样Override protected void onSaveInstanceState(Bundle outState) { super.onSaveInstanceState(outState); int[][] board mGobangView.getBoardData(); outState.putSerializable(board_key, board); outState.putBoolean(is_black, mGobangView.getCurrentTurn()); } Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); mGobangView findViewById(R.id.gobang_view); if (savedInstanceState ! null) { int[][] savedBoard (int[][]) savedInstanceState.getSerializable(board_key); mGobangView.restoreBoard(savedBoard); } }这种方式能解决多数课设的需求。要说缺点Serializable序列化二维数组性能一般但五子棋 15×15 的数据量很小毫无压力。如果你将来做一个 19×19 的围棋再考虑用单例存内存或数据库。5. 项目实战改造从单机双人到功能增强的进阶方向5.1 加入相对路径的棋子动画原项目的落子效果是瞬间完成的手指离开屏幕棋子直接出现在棋盘上。这其实没什么不好但如果想让视觉效果更顺滑可以给棋子加一个简单的缩放动画。常见做法是维护一个ArrayListChessAnimation记录每个棋子的落子时间在onDraw里根据时间差计算透明度或半径比例public class ChessAnimation { int row, col; long startTime; public ChessAnimation(int row, int col, long startTime) { this.row row; this.col col; this.startTime startTime; } }在onDraw绘制棋子时如果当前时间System.currentTimeMillis()与startTime的差值小于 200ms就用差值除 200 得到一个 0 到 1 的系数乘以棋子半径的一半让棋子从中心扩散式出现。200ms 这个参数可以自己试超过 300ms 会感觉拖沓低于 100ms 几乎看不出动画。这种动画完全在onDraw里做不需要引入ObjectAnimator和耗时的动画框架逻辑上更纯粹。5.2 悔棋按钮与菜单联动原项目的悔棋在菜单里但很多同学反馈找半天找不到。更好的交互是在棋盘下方加一排按钮悔棋、重新开始、退出。注意悔棋按钮要做一个防误触设计——玩家连续点悔棋时要把双方各退一步也就是一次悔棋弹出两个坐标自己的一步和对方的一步否则悔棋之后的局面会出现“同一方连走两步”的非法状态。实现时在栈里保存每一步的数据类型比如一个 int 数组{row, col, player}每次悔棋弹出两个元素恢复棋盘再交换回合。如果中途遇到游戏结束状态先重置mGameOver为 false再执行弹栈。项目原有的一次悔一个的写法建议改成双步悔棋否则对下棋体验影响很大。5.3 记录对局回放并导出利用已有的落子记录栈可以很轻松地做一个简单的回放功能把每一步的棋子状态存成一个快照不必全存只存序列回放时从第一帧开始每 300ms 推进一帧。最省内存的方案是只存{row, col, player}三元组回放时用一个临时棋盘逐帧重现。如果想把对局导出成文本写个私有字符串序列化也很容易大致做到这样private String exportGameRecord() { StringBuilder sb new StringBuilder(); for (int[] step : mStepStack) { sb.append(step[0]).append(,).append(step[1]).append(,).append(step[2]).append(;); } return sb.toString(); }这个字符串可以写入应用私有目录也可以直接分享。答辩的时候把“最近一局回放 导出文本”作为功能亮点讲出来比单纯说“我实现了双人五子棋”要有说服力得多。5.4 增加简单 AI 回合可选如果课设要求“有智能对弈”效果可以给白棋写一个最简单的随机落子 AI遍历棋盘找到所有空位随机选一个落子。虽然策略笨但功能上成立。再往上一步可以加一个“进攻防守”策略——检查棋盘上有没有四连和冲三的位置优先堵对方的活四其次自己凑活四。这段逻辑不复杂但能明显提升观感。AI 落子必须放在子线程计算后postInvalidate()因为在主线程里做全盘扫描虽然 15×15 很快但如果你后续加了深度搜索就会造成界面卡顿。我做过一个含 AI 的版本核心函数就一个findBestMove传入棋盘数组和当前玩家颜色返回{row, col}。用“当前位置打分”的方式不用递归搜索也可以写到两百行以内。计科课设如果选了“五子棋”加 AI 是拉开分差的关键点。5.5 工程结构调整与代码注释规范交课设前我强烈建议做一次工程瘦身删掉项目里自带的 README、无用测试文件把包名改成自己的学号或项目名比如com.example.edu.gomoku。把字符串资源全部从代码中抽到strings.xml比如黑棋胜利就不该硬编码在 Java 文件里。AndroidManifest.xml里把android:label改成你的课程作业名App 图标换一张自己画的哪怕只是改配色这样答辩时软件整体感强很多。代码注释不要每行都写而是在方法头写清输入、输出、边界约束比如checkWin方法上方注释写“从落子点向四个方向统计连子数任一方向 ≥5 返回 true”比贴满屏的// 这是棋盘有价值得多。6. 效果验证与答辩自检在交项目前强制走一遍的清单先把项目装到模拟器或真机上。模拟器推荐 API 28 以下的镜像运行更快。检查横竖屏切换如果没锁定方向、落子是否准确、连击五子是否弹窗、悔棋是否正常、平局条件是否触发最后看一下内存占用和旋转后的状态恢复。用 Android Studio 自带的 Profiler 观察内存没有泄漏即可这个项目数据量小一般不会出问题。在模拟器上安装时可以顺便跑一下adb shell dumpsys activity activities查看当前 Activity 是否有异常重启。另一个实用验证断网状态下安装运行避免项目里如果有网络权限请求被系统拦截引起闪退。之后做一次完整的 UI 走查棋盘四边是否完整、黑子和白子颜色是否鲜明红绿色弱的同学可以改蓝色对橙色、落子时是否出现点不到格子边缘的情况。触摸体验上如果感觉点不准多半是mCellSize换算没做四舍五入把(int)(y / mCellSize)改成Math.round(y / mCellSize)会准一些。答辩前把MainActivity.java跑起来后重点点几个位置棋盘四角、中心天元、边缘线交点。四角是最容易出换算误差的地方中心是判定逻辑最容易出问题的地方。真机上测试时尤其注意“落子后显示的位置”和“手指实际点击的位置”是否一致如果偏了一格检查mOffsetX和mOffsetY的计算。下面是我这几年反复使用的检查清单直接照做就行在模拟器和真机上各运行一次完整对局黑棋五连后确认白棋不能再落子。点悔棋按钮连续两次确认双方回合没有错乱且棋盘上消失的是最后两步棋。下到第 224 手时故意不产生五连确认平局提示正常弹出。杀进程重新打开 App确认回到了初始棋盘状态这个项目默认没有持久化需要你加的话可以存到 SharedPreferences。Android Studio 的 Logcat 中确认没有任何红色异常输出System.out的调试信息移除干净。代码中有一个isValidPosition判断没有被用到的话建议直接删掉否则会让代码变得冗余。真正的项目里不要留着“可能以后会用”的死代码答辩老师看到会问。我还遇到过把调试用的Log.d留在循环里刷屏的版本Logcat 被刷到卡顿观感很差务必清掉。就我自己经验而言交课设那天最容易翻车的永远是演示环境换了台电脑Android Studio 版本不同SDK 路径变了Gradle 同步失败当场就懵了。还记得那一次我带项目去实验室用老师的电脑打开工程等了五分钟 Gradle 一直在下载依赖后来发现项目的distributionUrl指的还是老版本 Gradle网络又慢教学电脑还限速演示尬在那里。从那以后我每做一个项目都会压缩一个 zip 副本里面同时包含源码和一份README.md写上“首次打开请等待 Gradle 同步完成若同步失败请把 gradle-wrapper.properties 中的 distributionUrl 改成你本地已有的版本”并把 Android Studio 版本、JDK 版本、SDK Platform 版本三个关键信息写清楚。这个习惯帮我在答辩时避开了无数环境坑希望也能帮到你。本文还有配套的精品资源点击获取
简介基于Android Studio 4.0.1开发的五子棋对战小游戏项目面向安卓开发学习者与计算机专业课程设计人群。项目提供人机对战和人人对战两种玩法人机模式支持单人挑战AI系统根据棋盘各落子点的得分评估自动决策并实时记录比赛得分人人对战由双方轮流下棋自动标记当前棋子颜色对局中可随时开始新游戏或悔棋主界面还能设置背景音乐开关、查看游戏介绍交互完整且易上手。资源压缩包共包含657个文件以Java源码、XML布局、Gradle配置、APK安装包及部分编译中间产物为主Java与XML文件分别承担业务逻辑和界面展示Gradle脚本负责构建流程APK可直接安装体验便于从源码到产物完整理解Android开发链路压缩包整体约30.71MB。目前已有2092人学习下载。整套实现涵盖棋盘绘制、落子判定、AI决策、悔棋逻辑与背景音乐控制等完整模块既能满足计科学生完成安卓课程设计的需要也可供希望深入理解Android自定义View、事件处理与基础算法设计的开发者参考并在此基础上进行功能扩展与二次修改。1. Android Studio 五子棋小游戏一个能写进课设的完整安卓项目先说结论这份资源不是那种只有几百行代码、跑起来就闪退的 Demo而是一个能在 Android Studio 里直接打开、编译、安装到真机或模拟器上的完整五子棋 App。它覆盖了自定义 View 绘制棋盘、双人对战逻辑、胜负判定、落子音效、悔棋、重新开始这些功能正好卡在安卓课设“不能太简单、又不能太复杂”的区间上。计科专业做移动应用开发课设拿它当底子改一改比从零写要稳妥得多。我拆过不下几十个安卓课设资源这个项目的价值在于棋盘和棋子是用自定义 View 画的不是贴图这意味着你能在代码里看到 Canvas、Paint、OnTouchEvent 这些核心 API 的真实用法而不是被一堆 Fragment 和 RecyclerView 糊弄过去。适合正在学安卓开发、需要交课设、或者想搞明白自定义控件到底怎么回事的人。2. 项目结构与核心机制先把代码骨架摸清楚2.1 工程文件长什么样拿到项目后先在 Android Studio 里打开等 Gradle 同步完成。这个项目是标准的 Android 工程结构主代码都在app/src/main/java下面布局文件在res/layout资源文件在res/drawable和res/menu。先别急着点 Run把文件结构看一遍心里要有一张地图。一个典型的五子棋项目最少包含以下核心文件文件作用MainActivity.java入口 Activity负责加载布局、初始化棋盘、处理菜单事件GobangView.java核心自定义 View画棋盘、画棋子、处理触摸、判断胜负activity_main.xml主布局放置 GobangView 和底部按钮menu_main.xml菜单栏包含重新开始、悔棋等动作drawable/存放棋子、棋盘背景等图片资源values/strings.xml所有字符串资源方便后期替换打开MainActivity.java你会发现它做的事并不多setContentView加载布局拿到GobangView引用然后处理菜单点击。真正的游戏逻辑全在GobangView里这也是安卓自定义控件开发的典型范式——把需要频繁重绘的界面放进自定义 View用invalidate()触发重绘而不是依赖布局文件里堆组件。2.2 棋盘绘制的底层逻辑五子棋棋盘是 15×15 的网格绘制时要处理三件事画线、画棋子、处理落子位置。GobangView里有一段初始化代码核心是把屏幕尺寸算好让棋盘居中并留出边距Override protected void onSizeChanged(int w, int h, int oldw, int oldh) { super.onSizeChanged(w, h, oldw, oldh); // 棋盘宽度取屏幕宽和高中的较小值保证横竖屏都能完整显示 mBoardWidth Math.min(w, h); // 每个格子的边长 棋盘宽度 / 1415条线之间只有14个间隔 mCellSize mBoardWidth / 14.0f; // 棋盘起点往左上角偏移让整个棋盘在屏幕中央留出上下空间放落子 mOffsetX (w - mBoardWidth) / 2.0f; mOffsetY (h - mBoardWidth) / 2.0f; initGameData(); }这段代码里有几个关键点。onSizeChanged是 View 尺寸确定后的回调在这里拿到实际的屏幕宽高然后算出棋盘宽度、格子和偏移量。mBoardWidth取w和h的较小值是为了让棋盘是正方形——五子棋棋盘必须是 15×15 的正方形网格如果直接拿w当棋盘宽竖屏时棋盘会超出屏幕底部。mCellSize的计算用的是14而不是15因为 15 条线之间只有 14 个间隔这个细节很多人第一次写会搞错导致棋盘最后一条线画到屏幕外。绘制棋盘线时用Canvas.drawLine逐条画横竖各 15 条。画棋子时根据mBoard[i][j]数组的值判断0 表示空1 表示黑棋-1 表示白棋然后canvas.drawCircle画圆。每次触摸落子后调用invalidate()系统就会重新走一遍onDraw。2.3 落子与悔棋的实现方式GobangView的触摸事件是核心它通过onTouchEvent判断用户点击的位置然后把坐标换算成棋盘索引Override public boolean onTouchEvent(MotionEvent event) { if (mGameOver) { return super.onTouchEvent(event); } if (event.getAction() MotionEvent.ACTION_DOWN) { // 把触摸坐标减去偏移量再除以格子大小得到第几行第几列 float x event.getX() - mOffsetX; float y event.getY() - mOffsetY; int row (int) (y / mCellSize); int col (int) (x / mCellSize); if (row 0 row 15 col 0 col 15) { putPiece(row, col); } return true; } return super.onTouchEvent(event); }putPiece方法里会先检查当前交叉点上是否已有棋子没有则落子落子后把当前回合切换到对手再检查胜负最后invalidate()刷新界面。这里要注意屏幕坐标和棋盘坐标的换算event.getX()返回的是相对于 View 左上角的绝对坐标而棋盘可能因为屏幕比例和边距并没有从 View 左上角开始所以要先减mOffsetX和mOffsetY再做除法。很多人第一次写触摸棋盘棋子总是落在触摸点偏右下方向就是因为漏了偏移量换算。悔棋的逻辑也不是简单地把最后一个棋子置空。项目里用了一个栈Stackint[]来记录每一步的落子位置悔棋时从栈顶弹出上一个坐标把这个位置的棋盘数组值恢复为 0然后切换回合。这个栈同时负责回放——虽然这个项目没做回放功能但保留了栈结构你后续想加回放就很方便。3. 胜负判定与回合管理看懂这段代码就能举一反三3.1 五连子判定算法胜负判定是五子棋最核心的逻辑。常见做法是在每次落子后从当前落子点向四个方向水平、垂直、主对角线、副对角线分别数连子数量任一方向上连子数 ≥ 5 即获胜。GobangView里的判定方法长这样private boolean checkWin(int row, int col) { int currentPlayer mBoard[row][col]; // 四个方向横、竖、主对角线、副对角线 int[][] directions {{0,1}, {1,0}, {1,1}, {1,-1}}; for (int[] dir : directions) { int count 1; // 正方向数 for (int i 1; i 5; i) { int r row dir[0] * i; int c col dir[1] * i; if (r 0 || r 15 || c 0 || c 15 || mBoard[r][c] ! currentPlayer) { break; } count; } // 反方向数 for (int i 1; i 5; i) { int r row - dir[0] * i; int c col - dir[1] * i; if (r 0 || r 15 || c 0 || c 15 || mBoard[r][c] ! currentPlayer) { break; } count; } if (count 5) { return true; } } return false; }这段代码的思路是以落子点为中心向某个方向的正方向数到边界或遇到不同棋子为止再向反方向数把两段数量加起来。大于等于 5 就赢。方向数组{{0,1}, {1,0}, {1,1}, {1,-1}}分别代表水平、垂直、右下对角线、左下对角线前两个分量是行方向的偏移后两个是列方向偏移。注意{1,-1}这个方向是行加一同时列减一从视觉上就是往左下走加上反方向就是往右上走合起来正好覆盖副对角线。边界检查r 0 || r 15不能省。如果不做检查越界访问mBoard会抛出ArrayIndexOutOfBoundsExceptionApp 直接闪退。这个判定方法的时间复杂度是 O(1)因为总共只向四个方向各延伸 4 格跟棋盘大小无关性能上没有任何压力。3.2 回合切换与游戏状态管理mBoard是个int[mBoardSize][mBoardSize]的二维数组mIsBlack true表示当前轮到黑棋。每走一步mIsBlack !mIsBlack。mGameOver标志位在胜利或平局时置为true置位后onTouchEvent直接拦截所有触摸。项目还在onDraw里绘制了“再来一局”的悬浮文字按钮实际上是通过onTouchEvent判断点击区域是否落在按钮范围内实现的。一个值得留意的细节是initGameData方法它在 Activity 重建时会被调用负责把所有状态重置。这对应安卓系统的配置变更问题——手机旋转屏幕时 Activity 会销毁重建如果没有状态恢复机制棋盘就会清零。这个项目用了比较简单的方案把 Activity 的screenOrientation固定为竖屏绕开了旋转问题。如果你想支持横屏就得在onSaveInstanceState里保存棋盘数组或者在AndroidManifest.xml里配置android:configChanges。从这个角度说项目选竖屏锁定是有意为之的课设答辩时能主动说出这一点反而是加分项。3.3 平局判定与死局处理五子棋还有个边界状态棋盘下满但没人五连。项目的处理方式是维护一个落子计数每成功落子一次加一当计数等于 15×15225 时判定平局。平局后mGameOver true但提示文案是“平局”而不是“XX 获胜”。这段逻辑虽然不长却是完整游戏必备的闭环。很多新手项目只处理胜负不处理平局棋盘下满后继续点会数组越界这个坑在评审演示时特别容易翻车。4. 避坑与常见问题编译、运行、适配的实战排查记录4.1 编译环境问题Gradle 版本与 SDK 不匹配现象打开项目后 Gradle 同步失败报错Failed to resolve: com.android.support:support-annotations或者Unable to load class javax.xml.bind.JAXBException。原因项目用的是老版本的 Android Gradle PluginAGP而你本地的 Android Studio 版本较新JDK 版本从 8 升到了 11/17老 AGP 无法解析新 JDK 的模块系统同时compileSdkVersion指定的 SDK 版本本地没装。解决先看build.gradle里的gradle版本和com.android.tools.build:gradle版本。常见做法是直接把 AGP 升到当前 Android Studio 支持的版本比如 8.x然后把compileSdkVersion改成你本地已安装的 API Level。如果项目引用的是老的support库把com.android.support:appcompat-v7替换成新工程的androidx.appcompat:appcompat:1.x.x同时把MainActivity的继承类从Activity改为AppCompatActivity。注意从 support 库迁到 androidx光改依赖不够还要引入androidx.core:core并在 gradle.properties 里加一行android.useAndroidXtrue。4.2 真机运行提示安装失败现象手机连上 USBAndroid Studio 点击 RunBuild 成功后安装报错INSTALL_FAILED_UPDATE_INCOMPATIBLE或INSTALL_FAILED_USER_RESTRICTED。原因前者是因为手机上已经装过同一个包名的 App但签名不同比如之前装的是市场版现在装的是 debug 签名版无法覆盖安装。后者是华为等品牌手机默认开启了“开发人员选项”里的某些限制或者是 MIUI 需要在开发者选项里关闭“USB 安装监控”。解决INSTALL_FAILED_UPDATE_INCOMPATIBLE直接卸载手机上的旧版再安装。INSTALL_FAILED_USER_RESTRICTED去开发者选项里打开“USB 安装”小米还要设置一个锁屏密码才能开启。另外Android 11 及以上系统用 debug 签名安装到真机没问题但如果项目配置了android:testOnlytrue真机安装会直接失败检查 AndroidManifest 里有没有这个属性有就删掉。4.3 棋盘绘制比例不对棋子挤在一起现象在模拟器和真机上棋盘大小不一致真机大屏上棋子偏小棋盘线离屏幕边缘太近或者在横屏状态下棋盘被拉伸变形。原因项目在onSizeChanged里用Math.min(w, h)取边长本意是自适应但你改了AndroidManifest.xml里的screenOrientation或者你的真机屏幕长宽比特殊比如带刘海屏导致mOffsetX和mOffsetY计算结果没有被重新计算。解决改完布局或旋转方向后强制在onLayout里重新计算一遍所有几何参数。我在这个项目中踩过最典型的坑参考了网上一个版本把onSizeChanged里的mBoardWidth Math.min(w, h)改成了mBoardWidth w结果竖屏没问题横屏棋子全部画到屏幕外。后来统一用onSizeChanged里的三元判断并且把棋盘边距算进mOffset里问题解决。顺带说一句五子棋棋子的半径不要硬编码用mCellSize * 0.42这种相对值不同分辨率下才能保持协调。4.4 invalidate 不生效界面不刷新现象点击棋盘时没有任何反应或者棋子出现但一直不消失。原因onTouchEvent里没有调用invalidate()或者刷新线程和 UI 线程冲突。项目本身是单线程触摸事件正常情况下点一下就应该走onDraw。如果你自己加了悔棋按钮但忘了在按钮点击后调invalidate()棋子在画面上不会消失。解决记住一个规律任何改变棋子状态的操作最后必须补一句invalidate()。如果是跨线程操作比如用 Handler 延迟下棋必须通过runOnUiThread或在 View 上直接postInvalidate()否则只能在线程里postInvalidate不能直接调invalidate。这个坑在加“电脑 AI 自动下棋”功能时特别容易出现——你跑一个子线程算棋算完直接改数组不刷新界面就像冻住了一样。4.5 屏幕尺寸适配问题刘海屏和全面屏现象在华为、小米等全面屏手机上棋盘整体偏上或偏下底部按钮被导航栏遮挡。原因Android 默认的沉浸式布局在 18:9 以上的屏幕上有信息区域重叠问题而项目的布局用了固定高度没有考虑系统导航栏和状态栏占位。解决在activity_main.xml里给最外层布局设置android:fitsSystemWindowstrue或者用ConstraintLayout把棋盘约束到居中底部按钮约束到棋盘下方而不是从屏幕底往上推。真机上有老项目的通用做法在 AndroidManifest 里给 Activity 加android:windowSoftInputModeadjustResize但这治标不治本。我自己的习惯是拿到任何课设项目先跑一遍不同分辨率的模拟器专门检查键盘弹起和底部导航栏遮挡这一步能避免答辩时被老师当场发现适配问题。4.6 重启 Activity 后棋盘数据丢失现象按 Home 键切后台再回 App棋盘还在但转屏后棋盘全空或者切到多任务再回来偶尔会白屏。原因这个项目固定竖屏转屏问题被绕开了。但如果你改成支持横屏系统默认会销毁 Activity 重建而mBoard数组是成员变量重建后所有数据归零。解决让 Activity 实现onSaveInstanceState把二维数组序列化到 Bundle 里在onCreate里恢复。代码大概长这样Override protected void onSaveInstanceState(Bundle outState) { super.onSaveInstanceState(outState); int[][] board mGobangView.getBoardData(); outState.putSerializable(board_key, board); outState.putBoolean(is_black, mGobangView.getCurrentTurn()); } Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); mGobangView findViewById(R.id.gobang_view); if (savedInstanceState ! null) { int[][] savedBoard (int[][]) savedInstanceState.getSerializable(board_key); mGobangView.restoreBoard(savedBoard); } }这种方式能解决多数课设的需求。要说缺点Serializable序列化二维数组性能一般但五子棋 15×15 的数据量很小毫无压力。如果你将来做一个 19×19 的围棋再考虑用单例存内存或数据库。5. 项目实战改造从单机双人到功能增强的进阶方向5.1 加入相对路径的棋子动画原项目的落子效果是瞬间完成的手指离开屏幕棋子直接出现在棋盘上。这其实没什么不好但如果想让视觉效果更顺滑可以给棋子加一个简单的缩放动画。常见做法是维护一个ArrayListChessAnimation记录每个棋子的落子时间在onDraw里根据时间差计算透明度或半径比例public class ChessAnimation { int row, col; long startTime; public ChessAnimation(int row, int col, long startTime) { this.row row; this.col col; this.startTime startTime; } }在onDraw绘制棋子时如果当前时间System.currentTimeMillis()与startTime的差值小于 200ms就用差值除 200 得到一个 0 到 1 的系数乘以棋子半径的一半让棋子从中心扩散式出现。200ms 这个参数可以自己试超过 300ms 会感觉拖沓低于 100ms 几乎看不出动画。这种动画完全在onDraw里做不需要引入ObjectAnimator和耗时的动画框架逻辑上更纯粹。5.2 悔棋按钮与菜单联动原项目的悔棋在菜单里但很多同学反馈找半天找不到。更好的交互是在棋盘下方加一排按钮悔棋、重新开始、退出。注意悔棋按钮要做一个防误触设计——玩家连续点悔棋时要把双方各退一步也就是一次悔棋弹出两个坐标自己的一步和对方的一步否则悔棋之后的局面会出现“同一方连走两步”的非法状态。实现时在栈里保存每一步的数据类型比如一个 int 数组{row, col, player}每次悔棋弹出两个元素恢复棋盘再交换回合。如果中途遇到游戏结束状态先重置mGameOver为 false再执行弹栈。项目原有的一次悔一个的写法建议改成双步悔棋否则对下棋体验影响很大。5.3 记录对局回放并导出利用已有的落子记录栈可以很轻松地做一个简单的回放功能把每一步的棋子状态存成一个快照不必全存只存序列回放时从第一帧开始每 300ms 推进一帧。最省内存的方案是只存{row, col, player}三元组回放时用一个临时棋盘逐帧重现。如果想把对局导出成文本写个私有字符串序列化也很容易大致做到这样private String exportGameRecord() { StringBuilder sb new StringBuilder(); for (int[] step : mStepStack) { sb.append(step[0]).append(,).append(step[1]).append(,).append(step[2]).append(;); } return sb.toString(); }这个字符串可以写入应用私有目录也可以直接分享。答辩的时候把“最近一局回放 导出文本”作为功能亮点讲出来比单纯说“我实现了双人五子棋”要有说服力得多。5.4 增加简单 AI 回合可选如果课设要求“有智能对弈”效果可以给白棋写一个最简单的随机落子 AI遍历棋盘找到所有空位随机选一个落子。虽然策略笨但功能上成立。再往上一步可以加一个“进攻防守”策略——检查棋盘上有没有四连和冲三的位置优先堵对方的活四其次自己凑活四。这段逻辑不复杂但能明显提升观感。AI 落子必须放在子线程计算后postInvalidate()因为在主线程里做全盘扫描虽然 15×15 很快但如果你后续加了深度搜索就会造成界面卡顿。我做过一个含 AI 的版本核心函数就一个findBestMove传入棋盘数组和当前玩家颜色返回{row, col}。用“当前位置打分”的方式不用递归搜索也可以写到两百行以内。计科课设如果选了“五子棋”加 AI 是拉开分差的关键点。5.5 工程结构调整与代码注释规范交课设前我强烈建议做一次工程瘦身删掉项目里自带的 README、无用测试文件把包名改成自己的学号或项目名比如com.example.edu.gomoku。把字符串资源全部从代码中抽到strings.xml比如黑棋胜利就不该硬编码在 Java 文件里。AndroidManifest.xml里把android:label改成你的课程作业名App 图标换一张自己画的哪怕只是改配色这样答辩时软件整体感强很多。代码注释不要每行都写而是在方法头写清输入、输出、边界约束比如checkWin方法上方注释写“从落子点向四个方向统计连子数任一方向 ≥5 返回 true”比贴满屏的// 这是棋盘有价值得多。6. 效果验证与答辩自检在交项目前强制走一遍的清单先把项目装到模拟器或真机上。模拟器推荐 API 28 以下的镜像运行更快。检查横竖屏切换如果没锁定方向、落子是否准确、连击五子是否弹窗、悔棋是否正常、平局条件是否触发最后看一下内存占用和旋转后的状态恢复。用 Android Studio 自带的 Profiler 观察内存没有泄漏即可这个项目数据量小一般不会出问题。在模拟器上安装时可以顺便跑一下adb shell dumpsys activity activities查看当前 Activity 是否有异常重启。另一个实用验证断网状态下安装运行避免项目里如果有网络权限请求被系统拦截引起闪退。之后做一次完整的 UI 走查棋盘四边是否完整、黑子和白子颜色是否鲜明红绿色弱的同学可以改蓝色对橙色、落子时是否出现点不到格子边缘的情况。触摸体验上如果感觉点不准多半是mCellSize换算没做四舍五入把(int)(y / mCellSize)改成Math.round(y / mCellSize)会准一些。答辩前把MainActivity.java跑起来后重点点几个位置棋盘四角、中心天元、边缘线交点。四角是最容易出换算误差的地方中心是判定逻辑最容易出问题的地方。真机上测试时尤其注意“落子后显示的位置”和“手指实际点击的位置”是否一致如果偏了一格检查mOffsetX和mOffsetY的计算。下面是我这几年反复使用的检查清单直接照做就行在模拟器和真机上各运行一次完整对局黑棋五连后确认白棋不能再落子。点悔棋按钮连续两次确认双方回合没有错乱且棋盘上消失的是最后两步棋。下到第 224 手时故意不产生五连确认平局提示正常弹出。杀进程重新打开 App确认回到了初始棋盘状态这个项目默认没有持久化需要你加的话可以存到 SharedPreferences。Android Studio 的 Logcat 中确认没有任何红色异常输出System.out的调试信息移除干净。代码中有一个isValidPosition判断没有被用到的话建议直接删掉否则会让代码变得冗余。真正的项目里不要留着“可能以后会用”的死代码答辩老师看到会问。我还遇到过把调试用的Log.d留在循环里刷屏的版本Logcat 被刷到卡顿观感很差务必清掉。就我自己经验而言交课设那天最容易翻车的永远是演示环境换了台电脑Android Studio 版本不同SDK 路径变了Gradle 同步失败当场就懵了。还记得那一次我带项目去实验室用老师的电脑打开工程等了五分钟 Gradle 一直在下载依赖后来发现项目的distributionUrl指的还是老版本 Gradle网络又慢教学电脑还限速演示尬在那里。从那以后我每做一个项目都会压缩一个 zip 副本里面同时包含源码和一份README.md写上“首次打开请等待 Gradle 同步完成若同步失败请把 gradle-wrapper.properties 中的 distributionUrl 改成你本地已有的版本”并把 Android Studio 版本、JDK 版本、SDK Platform 版本三个关键信息写清楚。这个习惯帮我在答辩时避开了无数环境坑希望也能帮到你。本文还有配套的精品资源点击获取
