OSX 包管理卸载工具技术文档

1. 安装指南

安装步骤

OSX Packages Uninstaller 的安装过程非常简单，只需要执行以下命令：

[sudo] bash < <(curl -sL https://raw.github.com/mpapis/pkg_uninstaller/master/pkg-install)

配置环境变量

• 系统安装（需要sudo权限）：在 /etc/profile 文件中添加以下内容来更新系统环境变量：

echo 'PATH=$PATH:/opt/pkg_uninstaller' >> /etc/profile

• 用户安装（无需sudo权限）：在用户的 .bash_profile 文件中添加以下内容来更新当前用户的环境变量：

echo 'PATH=$PATH:$HOME/.pkg_uninstaller' >> $HOME/.bash_profile

请注意，两个命令中都需要使用单引号。

2. 项目使用说明

安装包文件

使用以下命令来安装包文件：

pkg-install <package_file.pkg>

执行此命令会在当前目录下创建一个名为 uninstall_<package_file_pkg>.sh 的卸载脚本。

卸载已安装的包

要卸载这个包，只需执行刚刚创建的卸载脚本：

./uninstall_<package_file_pkg>.sh

列出和卸载单个包

• 列出包：使用以下命令列出所有可用的包名称，可以选择通过名称来过滤：

pkg-list [name]

• 卸载包：使用以下命令卸载指定的包：

pkg-uninstall <name>

3. 项目API使用文档

项目中的脚本主要用于在包安装过程中内置卸载逻辑。以下是如何在包内部使用这些脚本的说明：

• 在安装前钩子中，调用以下脚本：

#!/bin/bash

pkg-wrapper before "your package name"

• 在安装后钩子中，调用以下脚本：

#!/bin/bash

pkg-wrapper after "your package name" /path/to/uninstaller_name.sh

• 在卸载钩子中，调用以下命令：

#!/bin/bash

/path/to/uninstaller_name.sh
rm /path/to/uninstaller_name.sh

确保在应用程序打包时包含了 pkg-wrapper 脚本，并在安装到磁盘后执行上述钩子。

4. 项目安装方式

如上所述，项目的安装方式通过curl命令直接从GitHub上下载并执行安装脚本。以下是安装命令：

[sudo] bash < <(curl -sL https://raw.github.com/mpapis/pkg_uninstaller/master/pkg-install)

请确保在执行这些命令时具有适当的权限，并根据需要选择系统安装或用户安装来配置环境变量。