| name | tina-native-lsp-runtime |
| description | TinaIDE native 编译运行、Android sysroot、tina-toolchain assets、clangd/LSP、Tree-sitter 与 PRoot 排障指南。用于处理 C/C++ 编译、clang/lld/clangd、语言服务、toolchain 包、queries/registry 或 PRoot 相关改动。 |
TinaIDE Native / LSP / Runtime
先读文件
core/compile/**：编译、工具链、sysroot 相关能力。core/lsp/**：语言服务 provider、remote/plugin/native 入口。core/ndk/**、core/proot/**、core/tree-sitter/**。app/src/main/java/com/wuxianggujun/tinaide/ui/compose/state/editor/LspEditorManager.kt。app/src/main/java/com/wuxianggujun/tinaide/ui/compose/state/editor/EditorContainerState.kt。app/src/main/java/com/wuxianggujun/tinaide/ui/compose/components/editor/TinaCodeEditorPage.kt。app/src/arm64/assets/tina-toolchain/current.properties。app/src/x86_64/assets/tina-toolchain/current.properties。tools/verify-tina-toolchain-package.ps1、tools/sync-tina-toolchain-assets.ps1。
项目事实
- 默认编译/LSP 依赖 native tina-toolchain + Android sysroot，不默认依赖 PRoot rootfs。
AndroidSysrootManager 与 AndroidNativeToolchainManager 是独立管理职责，不能合并。- toolchain assets 由
app/src/<abi>/assets/tina-toolchain/current.properties、tar.xz 和 sha256 约束。
- arm64 当前记录为
version=0.2.4、arch=aarch64、full=tinaide-toolchain-aarch64-v0.2.4-patched.tar.xz。
- x86_64 当前记录为
version=0.2.4、arch=x86_64、full=tinaide-toolchain-x86_64-v0.2.4-patched.tar.xz。
- Android sysroot 资产通过
app/src/<abi>/assets/android-sysroot/profiles.json 管理；同步时必须显式传入 SysrootAssetName，旧 android-sysroot-*-all.tar.xz 默认包名已移除。
- C/C++ LSP provider 包括 native clangd、PRoot clangd、remote LSP、plugin LSP。
- CMake / Make 使用内建语言服务，不默认走 clangd。
修改流程
- 先确认问题属于编译、LSP、Tree-sitter、toolchain assets 还是 PRoot。
- 搜索现有 manager/provider，不要新增平行实现。
- toolchain 包变更先更新对应 ABI assets、sha256 和
current.properties。
- LSP 状态或 UI 变更同时检查
LspEditorManager、EditorContainerState、TinaCodeEditorPage。
- Tree-sitter queries 变更按手动同步/生成流程处理。
禁止事项
- 不要把 PRoot 当默认 C/C++ 编译路径。
- 不要合并 sysroot manager 与 native toolchain manager 的职责。
- 不要手改生成的 language registry。
- 不要把
syncTreeSitterQueries 接入普通 Gradle build。
- 不要绕过 toolchain assets 校验。
验证
./gradlew :app:compileArm64DebugKotlin --console=plain
./gradlew :app:assembleArm64Debug --console=plain
pwsh ./tools/verify-tina-toolchain-package.ps1
- LSP UI 或状态变更跑相关 app/editor tests。
- Tree-sitter 改动检查 registry 生成任务和 ktlint 排除规则。
