#applications #kit #kits #dragon-os #dragonos应用开发工具 #dadk的工作原理

nightly bin+lib dadk

DragonOS Application Development Kit DragonOS应用开发工具

13 releases

0.1.11 Apr 27, 2024
0.1.10 Mar 19, 2024
0.1.7 Feb 17, 2024
0.1.6 Nov 24, 2023
0.1.0 Apr 25, 2023

#2 in #kits

25 downloads per month

GPL-2.0-only

195KB
4.5K SLoC

DADK - DragonOS Application Development Kit

DragonOS 应用开发工具

codecov

简介

DADK是一个用于开发DragonOS应用的工具包,设计目的是为了让开发者能够更加方便的开发DragonOS应用。

DADK做什么?

  • 自动配置libc等编译用户程序所需的环境
  • 自动处理软件库的依赖关系
  • 自动处理软件库的编译
  • 一键将软件库安装到DragonOS系统中

DADK不做什么?

  • DADK不会帮助开发者编写代码
  • DADK不提供任何开发DragonOS应用所需的API。这部分工作由libc等库来完成

License

DADK is licensed under the GPLv2 License.

快速开始

安装DADK

DADK是一个Rust程序,您可以通过Cargo来安装DADK。

# 从GitHub安装最新版
cargo install --git https://github.com/DragonOS-Community/DADK.git

# 从crates.io下载
cargo install dadk

DADK的工作原理

DADK使用(任务名,任务版本)来标识每个构建目标。当使用DADK构建DragonOS应用时,DADK会根据用户的配置文件,自动完成以下工作:

  • 解析配置文件,生成DADK任务列表
  • 根据DADK任务列表,进行拓扑排序。这一步会自动处理软件库的依赖关系。
  • 收集环境变量信息,并根据DADK任务列表,设置全局环境变量、任务环境变量。
  • 根据拓扑排序后的DADK任务列表,自动执行任务。

DADK与环境变量

环境变量的设置是DADK能正常工作的关键因素之一,您可以在您的编译脚本中,通过引用环境变量,来获得其他软件库的编译信息。 这是使得您的应用能够自动依赖其他软件库的关键一步。

只要您的编译脚本能够正确地引用环境变量,DADK就能够自动处理软件库的依赖关系。

全局环境变量

DADK会设置以下全局环境变量:

  • DADK_CACHE_ROOT:DADK的缓存根目录。您可以在编译脚本中,通过引用该环境变量,来获得DADK的缓存根目录。
  • DADK_BUILD_CACHE_DIR_任务名_任务版本:DADK的任务构建结果缓存目录。当您要引用其他软件库的构建结果时,可以通过该环境变量来获得。 同时,您也要在构建您的app时,把构建结果放到您的软件库的构建结果缓存目录(通过对应的环境变量获得)中。
  • DADK_SOURCE_CACHE_DIR_任务名_任务版本:DADK的某个任务的源码目录。当您要引用其他软件库的源码目录时,可以通过该环境变量来获得。

任务环境变量

  • DADK会为每个任务设置其自身在配置文件中指定的环境变量。
  • DADK会设置DADK_CURRENT_BUILD_DIR环境变量,其值与DADK_BUILD_CACHE_DIR_任务名_任务版本相同。方便您在编译脚本中引用,把构建结果拷贝到这里。

全局环境变量命名格式

全局环境变量中的任务名和任务版本,都会被转换为大写字母,并对特殊字符进行替换。替换表如下:

原字符 替换字符
. _
- _
\t _
空格 _
+ _
* _

举例:对于任务libc-0.1.0,其构建结果的全局环境变量名为DADK_BUILD_CACHE_DIR_LIBC_0_1_0

TODO

  • 支持从在线归档文件下载源码、构建好的软件库
  • 支持自动更新
  • 完善clean命令的逻辑

Dependencies

~13–26MB
~412K SLoC