Repolode
MostafaXS1

MostafaXS1/artcraft-android

将 ArtCraft 官方 Rust/egui 应用编译为本地签名的 arm64 Android APK 的构建工具。

Star
301
Fork
27
未关闭 Issue
9
最近提交
16小时前

这是什么?

ArtCraft Android Builder 可以把现有的 ArtCraft 桌面应用仓库打包成可安装的 Android 安装包。运行脚本并指定应用名(如 -pdfcraft 或 -photocraft),脚本会拉取应用源码、生成 NativeActivity 启动封装、编译 release 或 debug APK,并使用本地密钥库签名。支持的应用包括 PhotoCraft、VectorCraft、FilmCraft、PdfCraft、WordCraft、GridCraft、DeckCraft 和 CADCraft 等。

构建器在应用之上补充了 Android 相关的集成:为文本输入提供软键盘桥接,为中日韩、阿拉伯语、泰语等文字提供系统字体回退,并为各应用注册“打开方式”和分享菜单中的文件类型。偏好设置和自动保存文件存放在应用专属的外部存储中,可通过 USB 或 adb 访问。应用显示名称、包名和启动图标都可以通过命令行参数覆盖。

各应用的构建输出相互隔离,构建之间会保留源码检出目录中的本地修改。构建成功只能说明 Android 外壳编译通过,文件保存、音频、剪贴板和触控等功能仍需在真机上验证。需要超出通用启动器的应用可以使用持久化适配器。

核心功能

  • 01通过一条脚本命令从 ArtCraft 应用仓库构建 arm64 的 release 和 debug APK。
  • 02支持十二款 ArtCraft 应用,包括 PhotoCraft、VectorCraft、PdfCraft 和 CADCraft。
  • 03可通过命令行覆盖显示名称、包名和启动图标。
  • 04为各应用注册 Android“打开方式”和分享菜单中的文件类型。
  • 05提供软键盘桥接,并为非拉丁文字提供系统字体回退。
  • 06构建之间保留源码本地修改,并按应用隔离构建输出。

适用场景

  • 在 Android 手机或平板上运行 PhotoCraft、VectorCraft 等桌面创作工具。
  • 为自己的设备构建本地签名的 APK,用于测试 ArtCraft 应用。
  • 从其他 Android 应用中直接用 ArtCraft 应用打开 PDF、文档或表格。
  • 以不同名称或图标构建带有自定义标识的 ArtCraft Android 版本。

快速上手

  1. 1

    为某个应用(如 pdfcraft)构建优化的发布版 APK

    bash build.sh -pdfcraft
  2. 2

    改为构建调试版 APK(体积更大、速度更慢)

    bash build-debug.sh -pdfcraft
  3. 3

    或从发布页面下载预构建的应用

使用前须知

  • 仅生成 arm64 架构的 Android 版本,且需要从 Storytold 源代码仓库构建。
  • 本地签名的密钥库仅供本地使用,不适合公开发布。
  • 成功构建并不保证所有功能在移动端可用,文件访问、音频和触控需要在设备上测试。
  • 当通用启动器无法构建某些应用时,可能需要编写自定义适配器。

标签

常见问题

artcraft-android 是什么?
将 ArtCraft 官方 Rust/egui 应用编译为本地签名的 arm64 Android APK 的构建工具。 ArtCraft Android Builder 可以把现有的 ArtCraft 桌面应用仓库打包成可安装的 Android 安装包。运行脚本并指定应用名(如 -pdfcraft 或 -photocraft),脚本会拉取应用源码、生成 NativeActivity 启动封装、编译 release 或 debug APK,并使用本地密钥库签名。支持的应用包括 PhotoCraft、VectorCraft、FilmCraft、PdfCraft、WordCraft、GridCraft、DeckCraft 和 CADCraft 等。
artcraft-android 可以免费使用吗?用的什么许可证?
artcraft-android 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
artcraft-android 还在维护吗?
活跃维护中。artcraft-android 最近一次提交是在 2026年10月20日。
artcraft-android 适合用来做什么?
在 Android 手机或平板上运行 PhotoCraft、VectorCraft 等桌面创作工具。 为自己的设备构建本地签名的 APK,用于测试 ArtCraft 应用。 从其他 Android 应用中直接用 ArtCraft 应用打开 PDF、文档或表格。 以不同名称或图标构建带有自定义标识的 ArtCraft Android 版本。
artcraft-android 怎么安装和运行?
为某个应用(如 pdfcraft)构建优化的发布版 APK: bash build.sh -pdfcraft 改为构建调试版 APK(体积更大、速度更慢): bash build-debug.sh -pdfcraft 或从发布页面下载预构建的应用
在哪里获取 artcraft-android?
源代码和安装说明在 GitHub 上:https://github.com/MostafaXS1/artcraft-android

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目