MiNiQ（谜你丘）

MiNiQ 是一款面向 Android 的 Pokémon mini 掌机模拟器前端， 使用 Jetpack Compose 构建，并集成 PokeMini/libretro 模拟核心。

主要功能

• 游戏库列表与网格显示
• 游戏扫描、搜索和排序
• 自定义游戏封面
• 即时存档与存档管理
• 退出游戏时创建恢复存档
• 自动存档恢复
• 虚拟按键及布局编辑器
• 实体手柄映射与配置文件
• 画面、声音和高级选项
• 简体中文与英文界面
• 横屏、竖屏及屏幕安全区域适配

系统要求

• Android 7.0 或更高版本（API 24+）
• ARM64 设备（arm64-v8a）

获取源代码

克隆仓库时必须同时获取 PokeMini 子模块：

git clone --recurse-submodules <repository-url>

如果已经克隆但没有下载子模块：

git submodule update --init --recursive

构建

Windows 路径提示

Windows 用户建议将仓库克隆到较短路径，例如 C:\src\MiNiQ。本项目包含 NDK 原生编译，过长的工程路径 可能导致 ndk-build 在配置阶段失败。

建议使用与本项目兼容的 Android Studio 及其内置 JDK。

Windows 调试构建命令：

.\gradlew.bat assembleDebug

调试 APK 输出位置：

app\build\outputs\apk\debug\app-debug.apk

游戏文件

MiNiQ 不提供 Pokémon mini 商业游戏、ROM、封面图片或其他受 版权保护的游戏内容。

用户需要自行提供合法取得的 .min 游戏文件。

PokeMini 上游项目附带的 FreeBIOS 保留在其子模块中，并继续 遵循上游项目的授权及说明。

开源许可

MiNiQ 项目源代码按照 GNU General Public License version 3 或更高版本发布。完整许可见 LICENSE。

PokeMini 模拟核心作为独立 Git 子模块保留，并固定在以下提交：

132111b76343559860532a1ccc094f93f1ed5650

第三方组件及其许可证见 THIRD_PARTY_NOTICES.md。

致谢

• PokeMini 与 libretro 项目的开发者和贡献者
• Android、AndroidX、Jetpack Compose、Kotlin、Coil 和 Gradle 项目的开发者
• DuckStation 为部分界面组织和交互设计提供了参考；本项目不包含 或分发 DuckStation 的源代码及资源

免责声明

MiNiQ 是非官方开源项目，与 Nintendo、The Pokémon Company、 Creatures Inc.、GAME FREAK inc. 及其关联公司不存在隶属、 授权或赞助关系。

Pokémon、Pokémon mini 及相关名称和标识属于其各自权利人。 本项目中的名称仅用于说明模拟平台兼容性。