安装与卸载

应用安装与卸载

本文档详细介绍 GMSSH 应用的安装与卸载流程，帮助开发者了解应用生命周期管理的完整过程。

应用安装

安装流程

当用户在应用中心安装应用时，系统会执行以下步骤：

下载应用包：将应用安装包下载到用户服务器
解压安装：自动解压到指定目录
目录结构：应用将被安装到以下路径：

/.__gmssh/plugin/{组织名}/{应用名}/

创建桌面快捷方式

安装目录说明

{组织名}：开发者或组织的唯一标识
{应用名}：应用的唯一名称

注意事项

确保您开发的应用名称在组织内保持唯一性
避免使用系统保留的目录名称
应用名称应符合文件系统命名规范

应用卸载

卸载流程

应用卸载过程包含以下步骤：

检查卸载脚本：系统会在应用目录下查找 uninstall.sh 文件
执行卸载脚本：如果存在卸载脚本，系统会自动执行
清理应用文件：根据用户选择决定是否清除应用数据
删除应用目录：执行完成 sh脚本会删除应用目录

环境变量配置

在执行 uninstall.sh 脚本前，系统会设置以下环境变量：

变量名	类型	说明
`IsClean`	boolean	用户是否选择清除应用数据

true：用户勾选了"同时删除应用数据（包括设置/本地文件）"
false：用户未勾选，保留应用数据

卸载脚本示例

创建 uninstall.sh 文件来处理应用卸载逻辑：

#!/bin/bash

# 停止应用服务
echo "正在停止应用服务..."
# 在此添加停止服务的命令

# 根据 IsClean 环境变量决定是否清除数据
if [ "$IsClean" = "true" ]; then
    echo "清除应用数据..."
    # 删除配置文件
    rm -rf ./config/
    # 删除日志文件
    rm -rf ./logs/
    # 删除用户数据
    rm -rf ./data/
else
    echo "保留应用数据"
fi

echo "应用卸载完成"

用户界面说明

用户在卸载应用时会看到以下选项：

当用户勾选"同时删除应用数据（包括设置/本地文件）"时，IsClean 环境变量将被设置为 true。

开发建议

始终提供 uninstall.sh 脚本以确保应用能够正确卸载
在卸载脚本中妥善处理服务停止和资源清理
根据 IsClean 变量合理处理用户数据的保留或删除
添加适当的日志输出以便问题排查