39 lines
1.5 KiB
Markdown
39 lines
1.5 KiB
Markdown
# MCEF Android (ARM) Compatibility Patch
|
||
|
||
> **注意：这是一个修改版分支**
|
||
>
|
||
> 此仓库是原始 [CinemaMod/MCEF](https://github.com/CinemaMod/mcef) 项目的一个分支，专门为**安卓端(ARM架构)** 的 Minecraft Java 版提供基础兼容性支持。
|
||
|
||
## 项目概述
|
||
|
||
此分支对原始 MCEF 库进行了最小化修改，主要目标是让 MCEF 及相关模组（如 WebDisplays）能够在安卓平台的 Minecraft Java 版中正常加载和运行，避免因架构不兼容而导致的崩溃问题。
|
||
|
||
### ⚠️ 重要限制
|
||
|
||
- **❌ 无浏览器功能**：由于 Chromium 无法在安卓环境运行，所有与浏览器相关的功能均被禁用
|
||
- **✅ 基础兼容性**：模组可以正常加载，不会因 MCEF 初始化失败而导致游戏崩溃
|
||
- **🎯 最小化修改**：仅修改必要的部分，保持与原始代码的最大兼容性
|
||
|
||
## 技术实现
|
||
|
||
### 修改内容
|
||
|
||
1. **架构检测绕过**：禁用了对安卓(ARM)架构的严格检测
|
||
2. **初始化流程优化**：在检测到安卓平台时跳过 Chromium 相关初始化
|
||
3. **异常处理增强**：提供更友好的错误处理和降级方案
|
||
|
||
### 兼容性状态
|
||
|
||
| 平台 | 状态 | 说明 |
|
||
|------|------|------|
|
||
| **Android (ARM)** | ✅ 可加载 | 模组正常加载，基础功能可用 |
|
||
| **Windows/Linux/macOS** | ⚠️ 可能受影响 | 需要进一步测试，建议使用官方版本 |
|
||
|
||
## 快速开始
|
||
|
||
### 环境要求
|
||
|
||
- Minecraft: 1.21.1
|
||
- NeoForge: 对应 1.21.1 的最新版本
|
||
- 安卓设备：支持 ARM 架构的安卓设备
|