Win11运行Kickstarter安卓源码如何执行make bootstrap解决报错

报错原因 #

File google-services.json is missing报错并非代码拉取异常，本质是项目集成的Google服务套件需要专属配置文件，正式版配置属于Kickstarter官方私有资产，不会上传到公开开源仓库。项目预置的make bootstrap是一键初始化命令，bootstrap直译为引导，开源项目中这类命令的作用就是自动完成本地开发环境的所有前置配置，不需要开发者手动逐个补文件、改参数。

分步操作（纯新手向，无跳步） #

• 第一步：补全Windows系统缺失的make命令运行环境
  Windows默认不自带make命令执行能力，打开管理员权限的PowerShell，执行winget install GnuWin32.Make完成安装。安装完成后把默认安装路径C:\Program Files (x86)\GnuWin32\bin添加到系统环境变量的Path列表中，添加完成后关闭所有PowerShell窗口和Android Studio，重新打开PowerShell执行make -v，如果能输出make的版本信息，说明环境配置成功。
  额外检查：打开项目根目录下的local.properties文件，确认sdk.dir配置的路径和你本地Android SDK的存储路径一致，如果没有这个文件就手动新建，写入格式参考：sdk.dir=C\:\\Users\\你的电脑用户名\\AppData\\Local\\Android\\Sdk，注意路径里的反斜杠要写两个。
• 第二步：定位到正确的命令执行目录
  打开你本地存放android-oss项目的文件夹，进入能看到无后缀名的Makefile文件的根目录层，点击文件夹窗口顶部的地址栏，直接输入powershell后按回车，会直接弹出定位到当前项目路径的PowerShell窗口，不需要手动输入路径切换目录。
• 第三步：执行初始化命令
  在弹出的PowerShell窗口中直接输入make bootstrap按回车，等待命令执行完成即可。这个命令会自动完成三件事：
  1. 把项目自带的调试版google-services.json模板复制到构建流程扫描的所有目标路径
  2. 拉取构建需要的第三方依赖、生成本地调试用的签名配置占位文件
  3. 校验本地Android SDK、NDK版本和项目要求是否匹配
• 第四步：重新构建项目
  命令执行完成没有红色报错的话，切回Android Studio，点击顶部菜单栏Build -> Clean Project，清理完成后再点击Build -> Rebuild Project，之前的配置文件缺失报错就会消失。

常见踩坑排查

1. 不要自行下载非本项目的google-services.json塞入目录，项目自带的sample模板就是专门给本地调试用的，外部下载的文件包名不匹配会触发更多构建错误
2. 如果执行make bootstrap时提示权限不足，关闭当前PowerShell，右键选择「以管理员身份运行」PowerShell后重新切到项目目录执行命令即可
3. 如果命令执行完依然提示找不到json文件，手动找到项目根目录下的google-services.json.sample文件，重命名为google-services.json，分别复制到app模块根目录、各个构建风味对应的目录下即可

内容的提问来源于stack exchange，提问作者Lalit sharma