修改文档

Packaging-demo/README.md

@@ -0,0 +1,135 @@
+# APM 软件包打包流程
+
+本文档为开发者准备，若您只是想从 deb 软件包打包 APM 软件包，您可以通过 `amber-pm-convert`指令进行全自动一键转换
+
+通过 `apm search amber-pm- ` 即可搜索到所有可用的 base 列表
+
+---
+
+## APM 软件包结构规范
+
+在阅读前，请确保您对overlayfs有了基本的了解
+
+overlayfs 原理解析：https://www.cnblogs.com/arnoldlu/p/13055501.html
+
+
+---
+
+
+一个典型的 APM 软件/中层依赖包应当包含以下内容
+
+```
+├── DEBIAN
+│   ├── control
+│   └── postinst
+└── var
+    └── lib
+        └── apm
+            └── eom
+                ├── entries
+                │   ├── applications
+                │   ├── doc
+                │   ├── glib-2.0
+                │   └── man
+                ├── files
+                │   ├── core
+                │   └── work
+                ├── info
+                └── info_debug
+
+
+
+```
+
+* DEBIAN目录包含了软件包的基本信息和依赖的环境信息
+
+1. 以下是 control 文件的内容
+
+```
+Package: eom
+Version: 1.26.0-2-apm
+Architecture: amd64
+Maintainer: APM Converter <apm-convert@spark-app.store>
+Depends: amber-pm-bookworm
+Installed-Size: 45228
+Description: APM converted package from eom
+  This package was automatically converted from the original deb package.
+  Based on: amber-pm-bookworm
+
+
+```
+
+Package: 包名。应当唯一。若使用转换器进行转换，默认和原包名一致
+Version: 版本号。若使用转换器进行转换，默认在原版本号后加`-apm`
+Architecture: 软件包架构。同 dpkg 进行填写即可。若使用转换器进行转换，默认和原包架构一致
+Depends: 依赖包。填写直接依赖的base即可
+Installed-Size: 安装后的大小。若使用转换器进行转换，会自动填写
+Description: 包描述。若使用转换器进行转换，会自动填写
+
+
+2. 以下是 postinst 文件内容
+
+```
+#!/bin/bash
+PACKAGE_NAME="$DPKG_MAINTSCRIPT_PACKAGE"
+
+if [ "$1" = "remove" ] || [ "$1" = "purge" ]; then
+    echo "清理卸载残留"
+    rm -rf "/var/lib/apm/$PACKAGE_NAME"
+else
+    echo "非卸载，跳过清理"
+fi
+
+
+```
+若无特殊需求，内容保持一致即可，用于在卸载软件包后清理环境
+
+* /var/lib/apm 包含了APM 软件容器的文件和信息
+
+
+
+软件应当被放置在 /var/lib/apm/软件包名/ 处
+此处有两个目录，两个文件
+
+entries 可选，包含了软件包需要被放到 /usr/share/ 的文件，如 desktop icon 等
+files 必须，包含了软件包的 upperdir 和 workdir 
+info 必须，包含了直接依赖的base信息。若应用使用了多层的依赖，会一层一层寻找info信息，直到找到底层依赖
+info_debug 可选，包含了打包时解析的依赖信息
+
+entries下的内容同软件需要放置到 /usr/share/ 下的内容
+
+files的内容请见下一节
+
+## APM upperdir 制作流程
+
+以下为手动制作 upperdir 的流程
+
+首先，安装 apm 并使用`sudo apm install` 安装你所需要的 base  
+
+随后，新建三个文件夹，core，work 和 ace-env ,执行
+
+`sudo mount -t overlay  overlay   -o lowerdir='/var/lib/apm/apm/files/ace-env/var/lib/apm/base包的包名（如amber-pm-trixie）/files/ace-env',upperdir=core/,workdir=work/ ./ace-env`
+
+随后chroot进入进行安装操作，直接进行 apt install 或者其他都可以，完成后解除挂载 ./ace-env
+
+你便得到了：
+
+* core: 保存新增文件
+* work: 保存变更信息
+
+
+需把这两个目录重新拥有并权限换成755后放入对应的目录进行 apm 打包
+
+你也可以测试一下刚刚打包的软件
+
+fuse-overlayfs -o lowerdir='/var/lib/apm/apm/files/ace-env/var/lib/apm/base包的包名（如amber-pm-trixie）/files/ace-env',upperdir=core/,workdir=work/ ./ace-env
+
+即可只读挂载。这一步 apm run 包名 会帮你做好。
+
+> apm run 包名： 寻找 /var/lib/apm/包名/是否存在。若存在，根据info文件合成 fuser-overlayfs 参数进行挂载，随后用ACE工具chroot进入进行启动
+
+./ace-run 即可进入，可以尝试启动一下刚刚安装的应用
+
+## APM 打包
+
+使用 `dpkg-deb --build 软件包目录 输出目录` 即可进行打包

Packaging-demo/ace-run

@@ -0,0 +1,140 @@
+#!/bin/bash
+
+
+
+chrootEnvPath="${chrootEnvPath:-$(pwd)/ace-env}"
+
+
+
+non_root_user=$(who  | awk '{print $1}' | head -n 1)
+uid=$(id -u $non_root_user)
+
+
+#### This part is for args pharm
+if [ "$1" = "" ];then
+container_command="bash"
+else
+container_command="$1"
+shift
+for arg in "$@"; do
+        arg="$(echo "${arg}x" | sed 's|'\''|'\'\\\\\'\''|g')"
+        arg="${arg%x}"
+        container_command="${container_command} '${arg}'"
+done
+fi
+#########################################################################################
+##########合成bwrap 1. 基础函数配置段
+# 初始化 EXEC_COMMAND 为 bwrap 基础指令
+EXEC_COMMAND="bwrap --dev-bind / / bwrap"
+
+# add_command 函数定义
+function add_command() {
+    # 参数拼接，考虑到转义和空格的处理
+    for arg in "$@"; do
+        EXEC_COMMAND="${EXEC_COMMAND} ${arg}"
+    done
+}
+
+function add_env_var() {
+    local var_name="${1}"
+    local var_value="${2}"
+    if [ "$var_value" != "" ]; then    
+	add_command "--setenv $var_name $var_value"
+	
+    fi
+}
+##########合成bwrap 2. 特殊需求函数配置段
+function cursor_theme_dir_integration() {
+
+local directory=""
+if [ "$(id -u)" = "0" ]; then #####We don't want bother root to install themes,but will try to fix the unwriteable issue
+	mkdir -p $chrootEnvPath/usr/share/icons
+	chmod 777 -R $chrootEnvPath/usr/share/icons
+	return
+fi
+
+for directory in "/usr/share/icons"/*; do
+    # 检查是否为目录
+    if [ -d "$directory" ]; then
+        # 检查目录中是否存在 cursors 文件
+        if [ -d "$directory/cursors" ]; then
+        	if [ -w $chrootEnvPath/usr/share/icons ];then
+			add_command "--ro-bind-try $directory $directory"
+		fi
+        fi
+    fi
+done
+
+
+
+
+
+
+
+}
+##########合成bwrap 3. 环境变量和目录绑定配置段
+# 添加环境变量和其他初始设置
+ENV_VARS=(
+    "FAKEROOTDONTTRYCHOWN 1"
+    "PULSE_SERVER /run/user/\$uid/pulse/native"
+    "PATH /amber-ce-tools/bin-override:\$PATH"
+    "IS_ACE_ENV 1"
+    "XDG_DATA_DIRS /amber-ce-tools/additional-data-dir-in-container:\$XDG_DATA_DIRS"
+)
+
+BIND_DIRS=(
+    "--dev-bind $chrootEnvPath/ /"
+    "--dev-bind-try /media /media"
+    "--dev-bind-try /mnt /mnt"
+    "--dev-bind-try /tmp /tmp"
+    "--dev-bind-try /data /data"
+    "--dev-bind-try /dev /dev"
+    "--proc /proc"
+    "--dev-bind /sys /sys"
+    "--dev-bind /run /run"
+    "--dev-bind-try /run/user/\$uid/pulse /run/user/\$uid/pulse"
+    "--dev-bind / /host"
+    "--ro-bind-try /usr/share/themes /usr/local/share/themes"
+    "--ro-bind-try /usr/share/icons /usr/local/share/icons"
+    "--ro-bind-try /usr/share/fonts /usr/local/share/fonts"
+    "--dev-bind-try /etc/resolv.conf /etc/resolv.conf"
+    "--dev-bind-try /home /home"
+)
+EXTRA_ARGS=(
+    "--hostname Amber-PM"
+    "--unshare-uts"
+    "--cap-add CAP_SYS_ADMIN"
+)
+
+EXTRA_SCRIPTS=(
+    cursor_theme_dir_integration
+)
+
+##########合成bwrap 4. 合成并执行指令
+# 逐一添加到 EXEC_COMMAND
+for var in "${ENV_VARS[@]}"; do
+    add_env_var $var
+done
+
+for var in "${BIND_DIRS[@]}"; do
+    add_command "$var"
+done
+
+for var in "${EXTRA_ARGS[@]}"; do
+    add_command "$var"
+done
+
+for var in "${EXTRA_SCRIPTS[@]}"; do
+    $var
+done
+
+# 添加最终的 bash 命令
+add_command "bash -c \"${container_command}\""
+
+# 输出完整的 EXEC_COMMAND 以查看
+# echo "${EXEC_COMMAND}"
+
+# 注意: 实际执行时，请确保所有变量（如 $uid, $chrootEnvPath 等）都已正确定义
+eval ${EXEC_COMMAND}
+
+

Packaging-demo/merge.sh

@@ -0,0 +1 @@
+fuse-overlayfs   -o lowerdir=base/,upperdir=core/,workdir=temp/ ./ace-env/