[Feature] Add Android platform support

[WRXinYue]

Area

Other

Motivation / use case

As the developer of STS2 mod, I want this dependency to support Android so that users can run the mod on mobile devices.

Proposed solution

Add Android platform support.

Alternatives considered

No response

Additional context

Related: #13

[ritsukage-local-analyzer]

Warning

此分析由 AI 自动生成，仅供开发者参考，最终判断请以人工确认为准。如有疑问建议结合本地环境进一步复现确认。

摘要

Issue #33 是由 STS2 mod 开发者 WRXinYue 提交的功能请求，希望 RitsuLib 支持 Android 平台，以便用户在移动设备上运行 STS2 mod。该请求记录了引用关联 issue #13，但未提供具体的技术方案、环境信息或复现步骤。

核心判断：Android 支持的可行性取决于上游 Slay the Spire 2 是否已有或计划有 Android 版本及 mod 加载基础设施。RitsuLib 作为 Godot .NET 4.5.1 的 mod 框架库，理论上存在跨平台构建路径，但当前项目强依赖 sts2.dll、Steamworks.NET.dll 等 PC 专属程序集，且未包含任何平台抽象层。此 issue 在缺乏上游确认和具体需求说明的情况下，目前更适合作为「追踪 / 讨论」类 issue，而非可直接实施的开发任务。

问题描述

期望行为

• RitsuLib 提供 Android 平台支持，使依赖此库的 STS2 mod 能够在 Android 设备上运行。

实际行为

• 当前仓库无 Android 构建目标，所有引用均为 Windows/PC 平台程序集（sts2.dll、0Harmony.dll、Steamworks.NET.dll）。.csproj 中仅定义了 net9.0 目标框架，无 Android 相关 TFMoniker 或平台条件编译。

复现步骤

• 报告者未提供具体步骤；此 issue 为功能请求而非 bug。

环境与版本

报告中未提供环境信息。从仓库推断当前依赖链：

• Slay the Spire 2（兼容 API 版本：0.104.0 / 0.103.2）
• Godot .NET SDK 4.5.1
• .NET 9.0
• 无已声明的 Android 目标或平台特性。

反馈规范性提醒

模板覆盖情况

维度	状态	说明
复现步骤	缺失	功能请求，无可复现行为
期望/实际	部分	期望一句带过；实际的平台限制未描述
环境与版本	缺失	未提及目标 Android 版本、目标设备、Godot 导出配置等
日志/附件	缺失	无任何日志、截图或错误信息
标题与背景	含糊	"Add Android platform support" 范围过大，未拆分为可操作子任务

对报告者的可执行要求

• 明确是否需要 Android port 是 Slay the Spire 2 官方路线图的一部分，或需依靠社区（如 Godot Android 导出 + 第三方 mod loader）
• 提供目标 Android 版本范围（如 Android 10+）、目标设备类型（手机/平板）、以及预期 mod 加载方式（是否需要独立 APK、Godot 导出模板等）
• 补充关联 issue Android兼容层  #13 的上下文或其当前状态说明
• 说明是否已有在 Android 上成功运行 STS2 本体（非 mod）的经验或方案

原文摘录与理解

As the developer of STS2 mod, I want this dependency to support Android so that users can run the mod on mobile devices.

要点：报告者是 STS2 mod 开发者，场景是让下游用户在移动端使用 mod，而非开发者自身需要 Android 开发环境。

Related: #13

要点：事件链中存在另一关联 issue，但当前 issue payload 未附带 #13 的详情。若 #13 已讨论过平台支持的限制或先决条件，此处可能需要合并讨论。

分析

可能原因与涉及面

1. 上游平台依赖（最大制约）：RitsuLib 直接引用 sts2.dll（游戏本体程序集）、Steamworks.NET.dll（Steam 平台集成）、0Harmony.dll（运行时 IL 补丁）。若 STS2 无 Android 构建，这些程序集在 Android 上不存在或不兼容，RitsuLib 无法工作。
2. Godot .NET 导出限制：Godot 4.x 的 .NET 版本对 Android 导出存在已知限制（需匹配特定 .NET 运行时，mono 与 CoreCLR 差异）。即便 STS2 本身有 Android 端口，mod 的 EnableDynamicLoading 机制在移动端可能不适用或需要调整。
3. 平台抽象缺失：当前代码库无 #if ANDROID 条件编译或平台适配层；FileOperations、设置文件路径（%appdata%）等工具类均为 Windows 硬编码。
4. Mod 加载器架构：Loader 项目负责运行时按 API 版本选择 DLL，但此架构假设文件系统路径与桌面平台一致。

相关模块或配置（若可从上下文推断）

• STS2-RitsuLib.csproj：目标框架、程序集引用、EnableDynamicLoading、Copy Mod 目标
• Loader/STS2-RitsuLib-Loader.csproj：多 API 兼容加载器
• .gitignore：已含 /android/（Godot 4 标准忽略），表明仓库根目录可能预留了 Android 导出目录
• 设置路径硬编码（README 中 %appdata%\SlayTheSpire2\steam\<user_id>\...）需平台化

验证建议

• 确认 Slay the Spire 2 是否有 Android 版本或官方路线图中的移动端计划（此为前置条件）
• 若上游已支持 Android：在 Godot 4.5.1 .NET 环境中执行一次 Android 导出构建测试，记录 sts2.dll 等程序集在 Android 运行时上的可用性
• 检查 Loader 项目在 Android 上的程序集解析行为（DynamicLoading 是否受 .NET for Android 限制）
• 对 Utils/FileOperations.cs 中的 Windows 路径假设做一次全量 #if 审计

风险与未决

• 上游依赖不可控：若 STS2 无 Android 计划，此 issue 不具备实施基础，建议标注为 blocked/upstream
• 范围过大且无法拆分：issue 标题为「添加 Android 平台支持」但未细化为具体子任务（平台抽象层、Loader 适配、构建配置、CI 平台矩阵等），当前状态不可执行
• 关联 issue Android兼容层  #13 的状态未知：若 Android兼容层  #13 已有相关讨论或结论，本 issue 可能为重复/延续，需合并或引用
• 维护负担评估缺失：多平台支持引入后，每次 API 变更需跨平台验证；当前无 CI 矩阵或 Android 构建目标

---

English translation

Click to expand

Summary

Issue #33 is a feature request by STS2 mod developer WRXinYue for RitsuLib to support Android, so that users can run STS2 mods on mobile devices. The request references related issue #13 but provides no concrete technical proposal, environment details, or reproduction steps.

Core assessment: The feasibility of Android support depends on whether upstream Slay the Spire 2 has (or plans to have) an Android build and mod-loading infrastructure. RitsuLib, as a Godot .NET 4.5.1 mod framework library, theoretically has a cross-platform build path, but the project currently has hard dependencies on PC-specific assemblies (sts2.dll, Steamworks.NET.dll) and lacks any platform abstraction layer. Without upstream confirmation and detailed requirements, this issue is better suited as a tracking/discussion item rather than an actionable development task.

Problem Description

Expected Behavior

• RitsuLib provides Android platform support, enabling STS2 mods that depend on this library to run on Android devices.

Actual Behavior

• The repository has no Android build target. All references are to Windows/PC platform assemblies (sts2.dll, 0Harmony.dll, Steamworks.NET.dll). The .csproj files define only the net9.0 target framework with no Android-specific TFM or platform conditional compilation.

Reproduction Steps

• The reporter did not provide specific steps; this is a feature request, not a bug.

Environment and Version

No environment information was provided in the report. Inferred from the repository:

• Slay the Spire 2 (compatible API versions: 0.104.0 / 0.103.2)
• Godot .NET SDK 4.5.1
• .NET 9.0
• No declared Android target or platform feature flags.

Feedback Normative Reminders

Template Coverage

Dimension	Status	Note
Reproduction steps	Missing	Feature request; no reproducible behavior
Expected/Actual	Partial	Expected stated in one sentence; actual platform limitations not described
Environment & version	Missing	No target Android version, device type, or Godot export config specified
Logs/attachments	Missing	No logs, screenshots, or error output
Title & background	Vague	"Add Android platform support" is too broad — not broken into actionable sub-tasks

Actionable Requests for the Reporter

• Clarify whether an Android port is on the Slay the Spire 2 official roadmap, or would rely on community efforts (e.g., Godot Android export + third-party mod loader)
• Provide target Android version range (e.g., Android 10+), target device type (phone/tablet), and expected mod loading mechanism (standalone APK, Godot export template, etc.)
• Provide context from related issue Android兼容层  #13 or its current status
• Indicate whether there is existing experience or a known path for running STS2 itself (unmodded) on Android

Analysis

Likely Causes and Scope

1. Upstream platform dependency (primary blocker): RitsuLib directly references sts2.dll (game assembly), Steamworks.NET.dll (Steam integration), and 0Harmony.dll (runtime IL patching). If STS2 has no Android build, these assemblies are absent or incompatible on Android, making RitsuLib non-functional.
2. Godot .NET export limitations: Godot 4.x .NET edition has known constraints for Android export (requires matching .NET runtime, mono vs. CoreCLR differences). Even if STS2 itself had an Android port, the mod EnableDynamicLoading mechanism may not apply or may need adjustment on mobile.
3. No platform abstraction: The codebase has no #if ANDROID conditional compilation or platform adaptation layer. Utilities like FileOperations and the settings path (%appdata%) are Windows-hardcoded.
4. Mod loader architecture: The Loader project handles runtime API-version selection but assumes desktop file-system paths.

Relevant Modules or Configuration (inferable from context)

• STS2-RitsuLib.csproj: target framework, assembly references, EnableDynamicLoading, Copy Mod target
• Loader/STS2-RitsuLib-Loader.csproj: multi-API compatibility loader
• .gitignore: already includes /android/ (Godot 4 standard ignore), suggesting the repo root may have reserved space for Android export output
• Hardcoded settings path in README (%appdata%\SlayTheSpire2\steam\<user_id>\...) requires platform-agnostic handling

Verification Suggestions

• Confirm whether Slay the Spire 2 has an Android version or a mobile plan on the official roadmap (this is a prerequisite)
• If upstream supports Android: perform an Android export build test in the Godot 4.5.1 .NET environment and document the availability of sts2.dll and related assemblies on the Android runtime
• Verify the Loader project's assembly resolution behavior on Android (whether DynamicLoading is constrained by .NET for Android)
• Conduct a full #if audit of Windows path assumptions in Utils/FileOperations.cs

Risks and Open Questions

• Uncontrollable upstream dependency: If STS2 has no Android plan, this issue has no implementation basis. Recommend labeling blocked/upstream.
• Scope too broad to execute: The issue title says "Add Android platform support" but does not break down into concrete sub-tasks (platform abstraction layer, Loader adaptation, build configuration, CI platform matrix, etc.). Not actionable in current form.
• Status of related issue Android兼容层  #13 is unknown: If Android兼容层  #13 already has relevant discussion or conclusions, this issue may be a duplicate or continuation and should be merged or cross-referenced.
• Maintenance burden not assessed: Multi-platform support would require cross-platform verification for every API change. There is currently no CI matrix or Android build target.

---

工具侧记录

• BAKAOLC/STS2-RitsuLib#33 · 退出码 0 · 进程 136.91s
• deepseek-v4-pro · API 135841ms · 14 轮 · ↓51369 ↑4353 · 缓存读140288 写0 · $0.4358

[BAKAOLC]

理论设计上目前能最大程度上保持稳定运行的情况是直接在安卓移植版中嵌入，以排除热路径 patch 的需求，这会大幅度减少补丁需求并且绕过安卓系统的各种能力限制。
技术栈当前支持实施这个方案，并且已确认该方案可以实施，但实施时目前有以下待评估和讨论的问题：

• 需要持续长期的维护一个移植版分支，这可能需要一个稳定的脚本或系统辅助进行以减少重复工作量，尤其是 RitsuLib 的开发和发布频率较高，不太一定能稳定保持版本同步
• 对外 API 需要保持不变，且尽可能不影响大部分普通的 MOD 正常工作
• 该分支理论上完全不可能同时支持 BaseLib 工作，因为 BaseLib 存在极其大量的针对性 IL 处理，几乎无法保证命中（目前 BaseLib 甚至对于普通的编辑器运行都会丢失命中），因此需要显式声明相关信息
• 分支对于不同 Android 系统的支持程度稳定性需要进行确认

此外的其他方案仍在评估，但是相对稳定性应当都远低于该方案且实施难度在当前评估范围没有显著收益。
如果有其他对此熟悉的相关开发人员可以进行补充讨论