MostafaXS1/artcraft-android

选用指南

AI 根据 README 整理 · 2026/10/20 18:36:41

使用方式

通过命令行脚本使用，如 `bash build.sh -pdfcraft` 构建发布版APK，`bash build-debug.sh -pdfcraft` 构建调试版APK，支持通过选项覆盖应用名称、包名和图标。

查看 README 依据

Project links: [ArtCraft](https://getartcraft.com/) · [The Crafting Apps](https://getartcraft.com/apps) ## Quick start Run the scripts from any directory. Each script resolves its own location and switches to the project directory before building. ```sh bash build.sh -pdfcraft # Optimized release APK bash build-debug.sh -pdfcraft # Debug APK; larger and slower ``` Replace `-pdfcraft` with any supported app name. ## Supported apps ```text photocraft vectorcraft filmcraft lightcraft pdfcraft effectcraft designcraft figcraft wordcraft soundcraft deckcraft cadcraft gridcraft ```

App names are passed as command-line flags, such as `-photocraft` or `-vectorcraft`. ## Options | Option | Description | | --- | --- | | `-appname=<name>` | Override the Android display name. By default, the app's built-in title is used. | | `-packagename=<pkg>` | Override the Android package name. By default, the package is `com.artcraft.<app>`. | | `-appicon=<path>` | Use a custom launcher icon PNG. By default, the app's own icon is used. | | `-h`, `--help` | Show command help. | ## Examples ```sh # Build PhotoCraft bash build.sh -photocraft # Override the display name

部署要求

需要JDK 17-23，构建过程使用cargo-ndk和Gradle，需要Rust环境。

查看 README 依据

Each build compiles the app's Rust code with [cargo-ndk](https://github.com/bbqsrc/cargo-ndk) into a `jniLibs` tree and packages it with the Gradle Android Plugin (AGP 8.7.3 on the bundled Gradle 8.11.1 wrapper). The launcher runs as a GameActivity — Google's maintained Activity for native apps, whose Java half also hosts the soft keyboard input connection — so the APK's Java side links `androidx.games:games-activity` and AppCompat alongside the platform SDK.

Gradle needs a JDK in the 17–23 range. The builder uses the first one it finds on the machine and, when there is none, downloads Temurin JDK 21 into `.cache/jdk/` once. The signing keystore itself keeps being created with the system `keytool`. ## Porting model and adapter boundary The generic launcher targets native Rust/egui applications that expose `Session`, `Services`, and a public `*App` type from `crates/engine` and `crates/ui-egui`. Some applications need an app-specific adapter rather than the generic startup path. This can apply to apps with:

已知限制

构建成功仅确认Android启动壳编译通过，不保证所有应用工作流在移动端就绪，需在设备上验证文件访问、保存导出、音频、剪贴板、生命周期和触摸交互。

查看 README 依据

A failed build is recorded under `logs/`. Use [`adapters/README.md`](adapters/README.md) to add a persistent adapter for an app. A successful APK build confirms that the Android launch shell compiled; it does not, by itself, establish that every app workflow is ready for mobile use. Verify file access, save and export behavior, audio, clipboard, lifecycle handling, and touch interaction on a device. ## Runtime integration ### Preferences and recovery files