fix: 把错误的版本号传上来了

Signed-off-by: shenmo <jifengshenmo@outlook.com>

Packaging-demo/README.md

@@ -12,9 +12,20 @@
 
 overlayfs 原理解析：https://www.cnblogs.com/arnoldlu/p/13055501.html
 
-
 ---
 
+## OverlayFS 层叠顺序说明
+
+APM 使用 OverlayFS 来管理软件包的文件系统层级，从上到下的层叠顺序为：
+
+1. **Upperdir** - 当前包的可写层 `files/core/`
+2. **Info Layer Override** - 覆盖层指定的目录（位于所有依赖层之上）
+3. **依赖层** - 从 `info` 文件递归解析出的所有依赖包
+3. **底层** - 最基础的运行时环境
+
+这种层叠结构允许上层文件覆盖下层文件，实现依赖管理和自定义覆盖。
+
+---
 
 一个典型的 APM 软件/中层依赖包应当包含以下内容
 
@@ -30,21 +41,20 @@ overlayfs 原理解析：https://www.cnblogs.com/arnoldlu/p/13055501.html
                 │   ├── applications
                 │   ├── doc
                 │   ├── glib-2.0
-                │   └── man
+│   │   └── man
-                ├── files
+│   ├── files
-                │   ├── core
+│   │   ├── core
-                │   └── work
+│   │   └── work
                 ├── info
-                └── info_debug
+                └── info_layer_override  # 可选，用于自定义覆盖层
-
-
 
 ```
 
-* DEBIAN目录包含了软件包的基本信息和依赖的环境信息
+### DEBIAN 目录
 
-1. 以下是 control 文件的内容
+包含软件包的基本信息和依赖的环境信息
 
+**control 文件示例：**
 ```
 Package: eom
 Version: 1.26.0-2-apm
@@ -55,20 +65,16 @@ 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: 包名。应当唯一。若使用转换器进行转换，默认和原包名一致
+- **Package**: 包名，应当唯一。若使用转换器进行转换，默认和原包名一致
-Version: 版本号。若使用转换器进行转换，默认在原版本号后加`-apm`
+- **Version**: 版本号。若使用转换器进行转换，默认在原版本号后加 `-apm`
-Architecture: 软件包架构。同 dpkg 进行填写即可。若使用转换器进行转换，默认和原包架构一致
+- **Architecture**: 软件包架构，同 dpkg 规范填写
-Depends: 依赖包。填写直接依赖的base即可
+- **Depends**: 直接依赖的 base 包名
-Installed-Size: 安装后的大小。若使用转换器进行转换，会自动填写
+- **Installed-Size**: 安装后的大小，转换器会自动计算
-Description: 包描述。若使用转换器进行转换，会自动填写
+- **Description**: 包描述，转换器会自动填写
-
-
-2. 以下是 postinst 文件内容
 
+**postinst 文件内容：**
 ```
 #!/bin/bash
 PACKAGE_NAME="$DPKG_MAINTSCRIPT_PACKAGE"
@@ -87,63 +93,110 @@ done
 else
     echo "非卸载，跳过清理"
 fi
-
-
 ```
-若无特殊需求，内容保持一致即可，用于在卸载软件包后清理环境
 
-* /var/lib/apm 包含了APM 软件容器的文件和信息
+若无特殊需求，内容保持一致即可，用于在卸载软件包后清理环境。
+
+### /var/lib/apm 目录结构
+
+包含 APM 软件容器的文件和信息：
+
+- **entries** (可选)：包含需要放置到 `/usr/share/` 的文件，如 desktop、icon 等
+- **files** (必须)：包含软件包的 upperdir 和 workdir
+- **info** (必须)：包含直接依赖的 base 信息。若应用使用了多层的依赖，会一层一层寻找 info 信息，直到找到底层依赖。如填写 amber-pm-bookworm-spark-wine10 会自动解析出 amber-pm-bookworm
+- **info_layer_override** (可选)：用于指定自定义覆盖层的目录
+
+> 关于 Info: 使用多层的依赖并不是必须的，即使不使用也可以正常打包，但恰当地使用多层依赖可大大降低包体积。 可用的多层依赖见 `apm search amber-pm-[base名称]- ` 。若有必要，可申请新增 base 
 
 
+**entries 目录说明：**
+- `entries/applications`：存放 `.desktop` 文件
+- `entries/doc`：存放文档
+- `entries/glib-2.0`：存放 GLib 相关文件
+- `entries/man`：存放帮助文档
 
-软件应当被放置在 /var/lib/apm/软件包名/ 处
+> **重要提示**：`.desktop` 文件应当添加一行 `X-APM-APPID=包名` 来允许软件管理器管理应用
-此处有两个目录，两个文件
 
-entries 可选，包含了软件包需要被放到 /usr/share/ 的文件，如 desktop icon 等 
+### info_layer_override 文件
-files 必须，包含了软件包的 upperdir 和 workdir 
-info 必须，包含了直接依赖的base信息。若应用使用了多层的依赖，会一层一层寻找info信息，直到找到底层依赖
-info_debug 可选，包含了打包时解析的依赖信息
 
-entries下的内容同软件需要放置到 /usr/share/ 下的内容
+`info_layer_override` 是一个可选文件，用于在当前包的依赖层之上插入额外的覆盖层。这个功能在以下场景特别有用：
 
-> 注意： .desktop 文件应当新加一行 X-APM-APPID=包名 来允许软件管理器管理
+1. **自定义库版本**：覆盖依赖包中的特定库文件，如你想要用更新版本的 mesa 覆盖 debian 默认提供的版本作为运行环境
+2. **配置文件自定义**：使用自定义配置覆盖默认配置
+- **语法**：与 `info` 文件一致，每行一个包名
+- **层叠位置**：位于所有依赖层之上、当前包的 upperdir 之下
+- **文件位置**：`${PATH_PREFIX}/var/lib/apm/${coredir}/info_layer_override`
 
-files的内容请见下一节
+**示例：**
+假设您想用自定义的 `override-layer` 包来覆盖 `base-package` 中的某些文件：
+
+`my-package/info` 内容：
+```
+amber-pm-bookworm
+```
+
+`my-package/info_layer_override` 内容：
+```
+amber-pm-bookworm-mesa
+```
+
+最终的挂载 lowerdir 为：`amber-pm-bookworm-mesa:amber-pm-bookworm`
+
+这样，`override-layer` 中的文件会覆盖 `base-package` 中的同名文件（除非当前包的 upperdir 中也有该文件）。
 
 ## APM upperdir 制作流程
 
-以下为手动制作 upperdir 的流程
+以下为手动制作 upperdir 的流程：
 
-首先，安装 apm 并使用`sudo apm install` 安装你所需要的 base  
+1. **安装依赖**：首先安装 apm 并使用 `sudo apm install` 安装所需的 base
 
-随后，新建三个文件夹，core，work 和 ace-env ,执行
+2. **创建目录结构**：
+```bash
+mkdir -p 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`
+3. **挂载 overlay**：
+```bash
+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
+4. **chroot 安装**：chroot 进入 `./ace-env` 进行安装操作，可以使用 `apt install` 或其他方式
 
-你便得到了：
+5. **卸载并打包**：完成后解除挂载 `./ace-env`
 
-* core: 保存新增文件
+您将得到：
-* work: 保存变更信息
+- **core**：保存新增文件
+- **work**：保存变更信息
 
+将这两个目录权限设置为 755 后放入对应的目录进行 apm 打包。
 
-需把这两个目录重新拥有并权限换成755后放入对应的目录进行 apm 打包
+## APM 软件包测试
 
-你也可以测试一下刚刚打包的软件
+您可以测试刚刚打包的软件：
 
+```bash
 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` 文件（和可选的 `info_layer_override`）合成 fuse-overlayfs 参数进行挂载
+- 使用 ACE 工具 chroot 进入并启动应用
 
-> apm run 包名： 寻找 /var/lib/apm/包名/是否存在。若存在，根据info文件合成 fuser-overlayfs 参数进行挂载，随后用ACE工具chroot进入进行启动
+使用 `./ace-run` 即可进入容器环境，测试您安装的应用。
-
-./ace-run 即可进入，可以尝试启动一下刚刚安装的应用
 
 ## APM 打包
 
-使用 `dpkg-deb --build 软件包目录 输出目录` 即可进行打包
+使用以下命令进行打包：
+```bash
+dpkg-deb --build 软件包目录 输出目录
+```
 
 ## APM 底层 Base Runtime 的构建
 
 详见 https://gitee.com/amber-ce/amber-pm-common
+
+---
+
+**备注**：APM 打包工具和转换器会为您自动处理大部分复杂操作，手动打包主要用于特殊情况或自定义需求。

README.md

@@ -91,6 +91,8 @@ Commands:
 
 详见 [Packaging-demo](Packaging-demo)。
 
+> 1.1.5+ 版本支持了覆盖 base 功能，相见 https://gitee.com/amber-ce/amber-pm/blob/master/Packaging-demo/README.md#info_layer_override-%E6%96%87%E4%BB%B6
+
 ## APM 构建 Tips
 
 > 请 `cp -vr src pkg` 来创建一个准备配置的环境，随后 `./build.sh pkg` 即可进行进一步的打包操作

build.config

@@ -1 +1 @@
-@VERSION@=1.1.4
+@VERSION@=1.1.5

src/DEBIAN/control

@@ -4,7 +4,7 @@ Version: @VERSION@
 Architecture: amd64
 Maintainer: shenmo <shenmo@spark-app.store>
 Installed-Size: 49000
-Depends: bubblewrap, flatpak,  policykit-1 | pkexec | polkit-1 | polkit, systemd, procps,coreutils,fuse-overlayfs,xz-utils,libnotify-bin,curl,xdg-user-dirs,bash
+Depends: bubblewrap, flatpak,  policykit-1 | pkexec | polkit-1 | polkit, systemd, procps,coreutils,fuse-overlayfs,xz-utils | xz,libnotify-bin,curl,xdg-user-dirs,bash
 Recommends: dpkg, fakeroot, busybox
 Section: misc
 Conflicts: ace-host-integration

src/usr/bin/apm

@@ -63,10 +63,8 @@ apm_exec(){
     while : ; do
         # 构建info文件的路径
         next_info_file="${current_dir}/info"
-#        echo "${current_dir}/info"
         # 检查info文件是否存在
         if [[ ! -f "$next_info_file" ]]; then
-#            log.debug "No more info files found, stopping recursion."
             break
         fi
         
@@ -88,13 +86,39 @@ apm_exec(){
         # 尝试获取下一个依赖信息的路径
         local next_basedir=$(tail -n 1 "$next_info_file")
         if [[ -z "$next_basedir" || ! -d "${PATH_PREFIX}/var/lib/apm/${next_basedir}" ]]; then
-            log.debug "No further dependencies found, ending recursion."
             break
         fi
         # 更新当前目录，递归处理下一个依赖
         current_dir="${PATH_PREFIX}/var/lib/apm/${next_basedir}"
     done
     
+    # 添加info_layer_override功能
+    local override_file="${PATH_PREFIX}/var/lib/apm/${coredir}/info_layer_override"
+    if [[ -f "$override_file" ]]; then
+        log.debug "Found info_layer_override file: $override_file"
+        local override_dirs=()
+        
+        # 读取override文件并构建override目录数组
+        while IFS= read -r basedir; do
+            [[ -z "$basedir" ]] && continue
+            
+            # 检查override目录是否存在
+            if [[ -d "${PATH_PREFIX}/var/lib/apm/${basedir}/files/ace-env" ]]; then
+                override_dirs+=("${PATH_PREFIX}/var/lib/apm/${basedir}/files/ace-env")
+            elif [[ -d "${PATH_PREFIX}/var/lib/apm/${basedir}/files/core" ]]; then
+                override_dirs+=("${PATH_PREFIX}/var/lib/apm/${basedir}/files/core")
+            else
+                log.warn "Neither ace-env nor core directory found for override base: $basedir"
+            fi
+        done < "$override_file"
+        
+        # 将override目录插入到现有lowerdirs数组的最前面（最左侧/最顶层）
+        if [[ ${#override_dirs[@]} -gt 0 ]]; then
+            log.debug "Adding override directories to the top layer"
+            lowerdirs=("${override_dirs[@]}" "${lowerdirs[@]}")
+        fi
+    fi
+    
     # 检查是否找到了有效的lowerdir
     if [[ ${#lowerdirs[@]} -eq 0 ]]; then
         log.error "No valid lower directories found for package: $coredir"

src/usr/share/bash-completion/completions/apm

@@ -70,7 +70,7 @@ _apm()
     # supported options per command
     if [[ "$cur" == -* ]]; then
         case $command in
-            install|remove|purge|upgrade|dist-upgrade|full-upgrade|autoremove)
+            install|remove|purge|upgrade|dist-upgrade|full-upgrade|autoremove|autopurge)
                 COMPREPLY=( $( compgen -W '--show-progress
                   --fix-broken --purge --verbose-versions --auto-remove
                   -s --simulate --dry-run

src/var/lib/apm/apm/files/bin/amber-ce-configure-nvidia

@@ -14,29 +14,39 @@ log.error "需要把ace-env所在的路径设置为第一个参数"
 exit 1
 fi
 
-# 1\. 获取宿主机 NVIDIA 驱动版本
+# 1. 获取宿主机 NVIDIA 驱动版本
 nvidia_version=$(cat /sys/module/nvidia/version 2>/dev/null)
 if [ -z "$nvidia_version" ]; then
-    log.warn "无法获取 NVIDIA 驱动版本 Can not determine NVIDIA Driver version"
+#    log.warn "无法获取 NVIDIA 驱动版本 Can not determine NVIDIA Driver version"
     exit 1
 fi
 
-# 2\. 目标目录准备
+# 2. 目标目录准备
 ACE_DIR="$1"
 if [[ ! -e "${ACE_DIR}" ]];then
 log.error "未检测到 apm安装，请安装后再试 apm is not detected. Please try again after installation"
-log.info "请按回车关闭... Press Enter to close..."
-read
 exit 1
 fi
 mkdir -p "$ACE_DIR/usr/lib" "$ACE_DIR/usr/lib32"
 
+# 检查版本是否已存在且匹配
+if [ -f "$ACE_DIR/current_version" ]; then
+    existing_version=$(cat "$ACE_DIR/current_version")
+    if [ "$existing_version" = "$nvidia_version" ]; then
+#        log.info "NVIDIA 驱动版本未变化，跳过链接操作 NVIDIA Driver version unchanged, skipping linking."
+        exit 0
+    else
+        log.info "检测到 NVIDIA 驱动版本变化: $existing_version -> $nvidia_version"
+        log.info "NVIDIA Driver version changed: $existing_version -> $nvidia_version"
+    fi
+fi
+
 log.info "正在链接 NVIDIA 驱动库 Linking NVIDIA Driver Libs"
 
-# 3\. 收集库文件路径
+# 3. 收集库文件路径
 lib_list=$(ldconfig -p | grep -Ei "nvidia|libcuda" | cut -d'>' -f2)
 
-# 4\. 复制库文件
+# 4. 复制库文件
 copied=0
 for lib in $lib_list; do
     resolved=$(readlink -f "$lib") # 解析符号链接
@@ -48,7 +58,7 @@ for lib in $lib_list; do
     fi
 done
 
-# 5\. 复制辅助文件
+# 5. 复制辅助文件
 additional_files=(
     /usr/share/vulkan/icd.d/nvidia_icd.json
     /usr/share/egl/egl_external_platform.d/20_nvidia_xcb.json
@@ -62,7 +72,7 @@ for file in "${additional_files[@]}"; do
     fi
 done
 
-# 6\. 标记版本
+# 6. 标记版本
 if [ $copied -eq 1 ]; then
     echo "$nvidia_version" > "$ACE_DIR/current_version"
     log.info "NVIDIA 驱动库已成功链接 Nvidia Driver Libs are successfully linked. "

src/var/lib/apm/apm/files/feedback.sh

@@ -1,9 +1,10 @@
 #!/bin/bash
 
 # 提取配置信息
-VERSION=@VERSION@-apm
+VERSION_FEEDBACK=@VERSION@-apm
 UUID=$(cat /etc/machine-id 2>/dev/null || echo "unknown")
 
+
 # 获取系统信息 - 不依赖 lsb_release
 if [ -f /etc/os-release ]; then
     # 现代 Linux 系统使用 /etc/os-release
@@ -35,7 +36,7 @@ JSON_DATA=$(cat <<EOF
   "Distributor ID": "$DISTRIBUTOR_ID",
   "Release": "$RELEASE",
   "Architecture": "$ARCHITECTURE",
-  "Store_Version": "$VERSION",
+  "Store_Version": "$VERSION_FEEDBACK",
   "UUID": "$UUID",
   "TIME": "$CURRENT_TIME"
 }