简介:StoneAgeMobileApp 是一份面向移动开发学习者与跨平台研究者的开源代码合集,提供石器时代手机端在 Android 与 iOS 两大平台上的完整实现,适合想了解双端应用架构、组件用法与跨平台兼容思路的初中级开发者参考。资源包共收录 10335 个文件,压缩后约 37.05MB,类型相当丰富:2662 个 h 与 1826 个 c 头源文件、324 个 cpp 构成底层逻辑,1031 个 html 与 66 个 java 对应界面与 Android 业务代码,另有 89 个 m、47 个 pbxproj、20 个 xcodeproj 等 iOS 工程文件,以及 mk、vcproj、sln 等构建配置,可直观看到多平台工程的组织方式。目前已有 1064 人学习下载。通过阅读源码,读者能梳理 Activity、Service 等四大组件的调用链,理解 Swift/Objective-C 下 UIKit 与数据存储的实现,并借鉴 React Native、Flutter 等跨平台框架的兼容与性能优化经验,是研究移动端开源项目结构的一份实用素材。
1. 石器时代手机端源码:从资源解包到双端复现的真实路径
手里拿到一份 StoneAgeMobileApp 的 Android 与 iOS 源代码,第一反应往往不是兴奋,而是发懵——目录里躺着 assets、lib、res、Payload 几大块,资源格式和端游时代完全不是一回事。石器时代这个 IP 在手机端有过多个衍生版本,流传出来的源码包通常包含 Unity 或 Cocos 导出的资源、部分反编译的 Java/Kotlin 与 Objective-C/Swift 胶水层,以及一堆加密过的图片和配置表。它解决的核心问题是:让你能在本地把一套完整的回合制 MMO 客户端跑起来,研究它的战斗结算、宠物养成、地图寻路和网络同步逻辑。适合谁?适合想拆解经典回合制手游架构的 Android/iOS 开发者、想复刻宠物数值系统的独立团队,以及需要一套可运行客户端做协议联调的服务端工程师。但先说清楚:这不是一份能直接上架的工程,资源加密、依赖缺失、签名失效是常态,你得有拆包和补环境的心理准备。
2. 拿到源码包先做什么:目录结构与资源格式判定
2.1 Android 侧:apk 解包后到底看什么
多数流传的石器时代手机端 Android 部分是以 apk 或已解包的工程目录形式存在。如果你拿到的是 apk,第一步不是急着反编译 dex,而是先看 assets 和 lib 两个目录,它们决定了这个包是 Unity 还是 Cocos 还是原生 Java 混合。
# 用 apktool 解包,保留资源原始结构
apktool d StoneAgeMobile.apk -o stoneage_android
# 查看关键目录
ls stoneage_android/assets/
ls stoneage_android/lib/arm64-v8a/
执行后你会看到几种典型情况: assets/bin/Data 存在说明是 Unity 导出; assets/src 加 assets/res 说明是 Cocos2d-x; lib 下出现 libil2cpp.so 说明是 Unity IL2CPP 编译,逻辑在 so 里而非 dex;出现 libcocos2djs.so 则是 Cocos 的 JS 绑定。这一步的判定直接决定后续走哪条路——IL2CPP 要面对 global-metadata.dat,Cocos 要面对 jsc 或 luac 加密。
参数说明: apktool d 的 -o 指定输出目录,不加 -f 时遇到已存在目录会报错,建议每次换新目录名。如果 apktool 报 Could not decode arsc file ,说明资源表用了非常规混淆,换 --frame-path 指定框架或改用 apktool --use-aapt2 。
2.2 iOS 侧:Payload 里的 Mach-O 与资源分离
iOS 源码包通常是 ipa 解压后的 Payload/StoneAge.app 目录。和 Android 不同,iOS 的可执行文件是 Mach-O 格式,资源集中在 .app 根目录和 Frameworks 子目录。
# 解压 ipa
unzip StoneAgeMobile.ipa -d stoneage_ios
# 查看 Mach-O 架构
lipo -info stoneage_ios/Payload/StoneAge.app/StoneAge
# 列出加密段
otool -l stoneage_ios/Payload/StoneAge.app/StoneAge | grep -A4 crypt
lipo -info 输出 arm64 或 arm64 armv7 说明架构; otool 看 cryptid ,值为 1 表示 App Store 加密二进制,值为 0 表示已解密可直接分析。如果 cryptid 是 1,你需要先做砸壳处理才能用 Hopper 或 IDA 看逻辑。资源方面,iOS 版石器时代常见 .png 被改成 .dat 或 .bin ,需要根据文件头魔数判断真实格式。
提示:iOS 资源文件名混淆比 Android 更常见,建议先用
file命令批量探测真实类型,再决定解密脚本。
2.3 资源加密的三种常见形态与识别方法
石器时代手机端源码里,资源加密基本逃不出三类:异或加密、头部偏移、以及自定义容器格式。识别方法很直接——用十六进制编辑器看文件头。
| 现象 | 可能加密方式 | 验证方法 |
|---|---|---|
| 文件头为随机字节,但长度规整 | 整体异或 | 尝试单字节异或 0x00-0xFF,看是否出现 PNG 头 |
| 前 16 字节乱码,之后出现 89 50 4E 47 | 头部偏移 | 用 dd 跳过前 N 字节 |
| 文件头为自定义 magic 如 SA01 | 容器封装 | 搜索源码中 magic 字符串定位解析函数 |
# 单字节异或爆破,快速判断是否异或加密
def brute_xor(path):
with open(path, 'rb') as f:
data = f.read(32)
for key in range(256):
decoded = bytes(b ^ key for b in data)
if decoded[:4] == b'\x89PNG' or decoded[:3] == b'\xff\xd8\xff':
print(f"key=0x{key:02x} hit")
return key
return None
逻辑说明:读取文件前 32 字节,对每个可能的单字节密钥做异或,检查结果是否匹配 PNG 或 JPEG 文件头。参数上, data 长度取 32 足够覆盖文件头,密钥范围 0-255 覆盖单字节全部可能。如果返回 None,说明不是单字节异或,转去检查头部偏移或容器格式。这个脚本我一般会批量跑整个资源目录,把命中结果按目录归类,能快速摸清加密规律。
3. 让工程在本地跑起来:Android Studio 与 Xcode 的环境补齐
3.1 Android 侧:Gradle 版本对齐与 so 缺失处理
石器时代手机端源码的 Android 工程,最常见的翻车点是 Gradle 版本和 so 库缺失。源码包里的 build.gradle 往往写着一个很老的插件版本,而你本地 Android Studio 是新版,直接同步必报错。
// 项目级 build.gradle 里调整插件版本
buildscript {
dependencies {
// 老工程常见 3.5.0 以下,按本地 AS 版本往上抬
classpath 'com.android.tools.build:gradle:7.4.2'
}
}
// app 级 build.gradle 里补 ndk abiFilters
android {
defaultConfig {
ndk {
// 只保留你实际有 so 的架构,避免打包报缺库
abiFilters 'arm64-v8a', 'armeabi-v7a'
}
}
}
逻辑说明:第一段把 AGP 版本抬到与本地 Android Studio 兼容的区间,7.4.2 对应 AS 2022 左右,再高需要同步改 Gradle Wrapper。第二段限制 abiFilters,是因为源码包经常只带了 arm64 的 so,如果你不加限制,构建时会去链接 x86 版本导致 UnsatisfiedLinkError 。参数上, abiFilters 里写几个架构,就要求 jniLibs 下必须有对应目录,缺一个都会在运行时报错。
如果同步后报 Could not find com.xxx:library ,说明源码依赖了私有仓库或已下架的库。常见做法是去 settings.gradle 里把对应仓库注释掉,然后手动把缺失的 aar 放进 libs 目录,用 implementation fileTree(dir: 'libs', include: ['*.aar']) 兜底。
3.2 iOS 侧:Xcode 签名、依赖与开发者模式
iOS 工程跑起来的第一道坎是签名。源码包里的 .xcodeproj 通常带着原开发者的 Team ID,你直接打开会报 No signing certificate 。
# 查看工程当前签名配置
xcodebuild -project StoneAge.xcodeproj -showBuildSettings | grep -i "CODE_SIGN"
输出里 CODE_SIGN_IDENTITY 和 DEVELOPMENT_TEAM 就是需要改的地方。在 Xcode 里选中 target,Signing & Capabilities 勾选 Automatically manage signing ,Team 换成你自己的 Apple ID 对应团队。如果是免费账号,Bundle Identifier 要改成唯一值,否则会报 Failed to register bundle identifier 。
依赖方面,老工程常用 CocoaPods,但 Podfile 里的源可能已经失效。常见做法是把 source 换成当前可用的 CDN 源,然后 pod install --repo-update 。如果报 The sandbox is not in sync with the Podfile.lock ,删掉 Pods 目录和 Podfile.lock 重新 install。
真机调试还需要在 iPhone 上开启开发者模式:设置 → 隐私与安全性 → 开发者模式 → 打开,重启后生效。这个开关在 iOS 16 以后藏得比较深,很多人找不到,以为是签名问题,其实是开发者模式没开。
3.3 双端资源目录的映射关系
Android 和 iOS 的资源目录命名不同,但内容往往同源。理解映射关系能帮你复用解包脚本。
| Android 路径 | iOS 路径 | 内容 |
|---|---|---|
| assets/bin/Data | StoneAge.app/Data | Unity 资源 |
| assets/res | StoneAge.app/res | 图片音频 |
| assets/config | StoneAge.app/config | 配置表 |
| lib/arm64-v8a | Frameworks | 原生库 |
我一般会先解 Android 侧,因为 apktool 和 assetstudio 工具链更成熟,解出来的资源格式确认后,再对照 iOS 侧做批量重命名。两边配置表如果都是加密的,优先攻破 Android 侧,因为 Java 层反编译比 Mach-O 容易定位解密函数。
4. 核心逻辑定位:战斗、宠物与网络协议怎么找
4.1 从字符串和配置表反推战斗结算
石器时代的核心玩法是回合制战斗,结算逻辑通常不在资源里,而在代码或脚本中。Android 侧如果 dex 没被加固,用 jadx 打开搜索关键词是最快的。
# jadx 反编译 dex 并搜索战斗相关类
jadx -d stoneage_decompiled stoneage_android/classes.dex
grep -rn "battle\|Battle\|combat\|damage" stoneage_decompiled/sources/ | head -50
搜索关键词建议用中英混合: battle 、 fight 、 damage 、 skill 、 宠物 、 战斗 。如果 dex 被加固,搜不到有效类,转去 assets 里找 Lua 或 JS 脚本。Cocos 系工程常见 assets/src/app/ 下有 .lua 或 .js ,即使被编译成 luac 或 jsc,也能通过文件头判断。
配置表方面,宠物属性、技能倍率通常在 config 目录的 Excel 导出文件里,格式可能是 csv、json 或自定义二进制。如果是二进制,用 010 Editor 配合结构模板看,或者找源码里的 ConfigLoader 类反推字段顺序。
4.2 网络协议:抓包与协议结构还原
回合制 MMO 的协议通常是 TCP 长连接加自定义包头。定位协议最直接的方法是抓包,但要注意——这里说的是分析你自己本地运行的客户端与服务端之间的通信,用于协议联调。
# 解析自定义包头:常见 2 字节长度 + 2 字节命令号
import struct
def parse_packet(data):
if len(data) < 4:
return None
length, cmd = struct.unpack('>HH', data[:4])
body = data[4:length]
print(f"cmd=0x{cmd:04x} len={length} body={body[:32].hex()}")
return cmd, body
逻辑说明:很多国产 MMO 用大端序 >HH 做包头,前两字节是总长度,后两字节是命令号。参数上, >HH 表示大端无符号短整型,如果你的抓包数据显示长度字段和实际不符,换成小端 <HH 再试。 body 打印前 32 字节十六进制,方便对照命令号猜结构。实际还原时,我会先抓登录和进入地图两个流程,因为这两个流程的命令号固定、字段少,容易验证包头解析是否正确。
如果协议体是 protobuf,抓包数据里会出现明显的字段标签;如果是自定义二进制,就需要结合反编译出的 MessageHandler 类逐个字段对。这个过程没有捷径,血泪经验是:先把命令号表整理出来,再逐个攻破,不要一上来就啃最复杂的战斗包。
4.3 宠物养成数值的提取与验证
宠物系统是石器时代源码里最值得研究的部分。数值通常分三层:基础属性表、成长率表、技能效果表。提取时要注意表之间的外键关系。
# 假设配置表是 csv,读取并建立宠物 ID 索引
import csv
pets = {}
with open('pet_base.csv', encoding='utf-8') as f:
for row in csv.DictReader(f):
pets[row['pet_id']] = {
'name': row['name'],
'hp': int(row['base_hp']),
'attack': int(row['base_atk']),
'growth': float(row['growth_rate'])
}
print(f"loaded {len(pets)} pets")
逻辑说明:用 pet_id 做主键建立字典,方便后续和成长率表、技能表做关联查询。参数上, growth_rate 用 float 是因为成长率常有小数。验证方法是找一只你熟悉的宠物,用提取出的数值手算 1 级到 50 级的属性,和游戏内实际值对比,偏差超过 5% 说明公式里还有隐藏系数没提取到。
注意:配置表如果加密,先按第 2 章的异或爆破处理,不要直接改文件后缀硬读,容易得到乱码还浪费时间。
5. 避坑与排查:源码复现中最容易翻车的五件事
5.1 现象:Gradle 同步卡在 Download 不动
原因:源码包里的仓库地址指向已失效的镜像或私有 Nexus,Gradle 一直重试直到超时。
解决:打开 settings.gradle 和项目级 build.gradle ,把所有 maven { url '...' } 逐个注释,换成 mavenCentral() 和 google() 。如果某个依赖确实只在私有仓库有,去搜同名库的公开版本,或者把 aar 手动放进 libs 。改完执行 ./gradlew --refresh-dependencies 强制刷新。
5.2 现象:iOS 真机运行闪退,控制台报 dyld: Library not loaded
原因:工程依赖了动态 Framework,但 Embed 选项没设对,或者 Framework 本身是模拟器架构。
解决:在 Xcode 的 General → Frameworks, Libraries, and Embedded Content 里,把对应 Framework 的 Embed 改成 Embed & Sign 。然后用 lipo -info 确认 Framework 包含 arm64 真机架构,如果只有 x86_64,需要找源码重新编译或换一份真机可用的。
5.3 现象:资源解密后图片花屏或音频无法播放
原因:异或密钥正确但作用范围不对,比如只加密了文件前 N 字节,你却对整个文件做了异或。
解决:回到十六进制编辑器,对比解密后文件头和文件尾。如果头部正常尾部乱,说明加密只覆盖头部;如果头部乱尾部正常,说明加密覆盖尾部。调整脚本只对加密区间做异或。音频文件还要检查采样率是否被改过,用 ffprobe 看真实参数。
5.4 现象:Android 运行报 UnsatisfiedLinkError: dlopen failed
原因:so 库依赖了源码包里没带的第三方 so,或者 so 是 32 位而设备是 64 位。
解决:用 readelf -d libxxx.so 看 NEEDED 字段,列出所有依赖库,缺哪个补哪个。架构问题用 file libxxx.so 确认,然后在 abiFilters 里只保留设备支持的架构。如果 so 是 Unity IL2CPP 的,还要确认 global-metadata.dat 和 so 版本匹配,不匹配会报 Metadata file does not match 。
5.5 现象:抓包看到协议但解析全是乱码
原因:协议体在包头之后还有一层压缩或加密,常见的是 zlib 压缩或简单异或。
解决:先看 body 前两字节是不是 78 9c 或 78 01 ,这是 zlib 头,用 zlib.decompress 解压。如果不是,尝试对 body 做单字节异或爆破,方法和资源解密一样。还不行就去看反编译代码里的 encode / decode 函数,通常能找到加密方式。我一般会先在登录包上验证,因为登录包字段少、结构固定,容易判断解析是否正确。
6. 进阶:用 Python 批量处理资源与协议验证脚本
走到这一步,你已经能把客户端跑起来、能定位核心逻辑了。接下来真正省时间的是把重复劳动脚本化。我自己的习惯是建一个 tools 目录,放三个脚本:资源批量解密、配置表转 json、协议包解析验证。
# batch_decrypt.py:按目录批量异或解密并保留原始文件
import os
import sys
def xor_decrypt(src, dst, key):
with open(src, 'rb') as f:
data = f.read()
out = bytes(b ^ key for b in data)
with open(dst, 'wb') as f:
f.write(out)
def walk_and_decrypt(root, out_root, key):
for dirpath, _, files in os.walk(root):
for name in files:
src = os.path.join(dirpath, name)
rel = os.path.relpath(src, root)
dst = os.path.join(out_root, rel)
os.makedirs(os.path.dirname(dst), exist_ok=True)
xor_decrypt(src, dst, key)
print(f"done, output at {out_root}")
if __name__ == '__main__':
walk_and_decrypt(sys.argv[1], sys.argv[2], int(sys.argv[3], 16))
逻辑说明: walk_and_decrypt 递归遍历源目录,保持相对路径结构输出到目标目录,避免文件名冲突。参数上,第三个参数是十六进制密钥,比如 0x5A 就传 5A 。这个脚本的关键是保留原始文件不动,输出到新目录,这样解密错了还能重来,不用重新解包。我一般会先用第 2 章的爆破脚本找到密钥,再跑这个批量处理。
配置表转 json 的脚本核心是处理编码和字段类型。很多国产配置表用 GBK 编码,直接 utf-8 读会报错,需要 encoding='gbk' 或 errors='ignore' 。字段类型转换时,空值要处理成默认值,否则后续计算会抛异常。
协议验证脚本我一般写成一个小型回放器:把抓包保存的二进制流按包头切分,逐包解析命令号和 body,输出成可读日志。这样当你改了服务端逻辑后,可以快速对比客户端发出的包是否变化。
| 脚本 | 输入 | 输出 | 关键参数 |
|---|---|---|---|
| batch_decrypt.py | 加密资源目录 | 解密后目录 | 异或密钥 |
| config2json.py | csv/xls 配置表 | json 文件 | 编码、字段类型映射 |
| packet_parser.py | 抓包二进制流 | 命令号+body 日志 | 字节序、包头长度 |
最后说一个我踩过的坑:不要一上来就想着把整个工程重构或移植到新引擎。石器时代手机端源码的价值在于它的数值设计和协议结构,先把这两块吃透,再考虑用现代引擎重写客户端。我见过太多人花两周配环境,然后花两个月重构,最后连战斗公式都没验证对。先把能跑通的流程跑通,再谈优化。希望帮到你。
本文系统解析石器时代手机端Android与iOS源码的完整复现路径,涵盖APK/IPA解包、资源加密识别(异或/头部偏移/自定义容器)、Gradle/Xcode环境适配、Mach-O砸壳与so库处理、战斗/宠物/网络协议定位方法,以及抓包协议还原、Python批量解密与验证脚本开发。重点面向移动端逆向、协议分析与跨平台复现场景,强调实战避坑与可运行客户端构建。
1万+

被折叠的 条评论
为什么被折叠?



