准备工作
概述
Virbox 用户工具是安装在最终用户机器上的一款应用软件,是开发商软件最终运行时环境,是软件和许可之间的桥梁,其屏蔽了一切底层接口,大大提升了软件访问加密锁和云平台的开发效率。而且,客户端内置了多种我公司顶尖安全技术,并且可以随时升级,而升级客户端并不会对开发者已发布的软件造成任何影响。客户端内置了我公司最先进的反黑引擎产品,可以有效打击盗版行为。客户端还包含了展示产品信息、查看许可信息、配置服务类型、升级许可数据、登录云账户、检测修复运行环境等功能,是 Virbox LM 不可或缺的一部分。
版本信息
Virbox 用户工具支持多种常用操作系统,以下表给为支持列表,本文为方便起见,以 Windows 操作系统下的操作为例做说明。Linux 操作手册请参考 Virbox 用户工具 Linux 版用户手册。
- Windows XP SP3 及以上
- Linux(x86)、Linux(ARM)
- macOS 10.9.2 及以上
- Android (设备)
为什么要安装 Virbox 用户工具
- 内置反黑引擎,安装了 Virbox 用户工具,就相当于安装了一套反黑引擎
- 内置通道加密,三层加密技术,破解无从入手
- 主动升级防御,高频更新安全策略,主动推送升级提醒,随时提升安全强度
- 屏蔽底层接口,统一许可访问接口,提高开发效率
- 网络锁功能,一锁多端,统一管理
- 展示开发者和产品信息,易于产品推广
说明
Smart License 不需要安装 Virbox 用户工具
获取安装包
有两种方式获取 Virbox 用户工具安装包。一种是通过官方网站 下载中心 获取最新版本的安装包;一种是通过 Virbox 开发者工具盒 获取安装包,如下图所示,打开文件目录,即可得到安装包。
我们建议您从官网下载最新的安装包使用,因为工具盒中的安装包更新频率比官网上的更新频率要低很多。
安装包所在目录和文件名称
安装客户端
Windows 版
直接安装
双击安装包进行安装,安装过程可选择指定安装目录(建议选择默认路径),我们在 快速入门 中已经讲过了,这里不再做介绍。
命令行安装
Virbox 用户工具支持命令行安装。因为用户工具是需要随着开发者的软件一起发布的,因此可以通过命令行进行静默安装等操作,命令行参数如下描述。
sense_shield_installer_pub.exe [/S] [/c no_driver] [/senseshield_hide_taskbar_icon] [/auto_install] [/not_create_desktop_shortcuts] [add_ss_restart_schtask --ss_restart_schtask_time=06:00:00]
参数列表
参数 | 说明 |
---|---|
/S | 静默安装(注意必须是大写) |
/c no_driver | 不安装加密锁驱动 |
/auto_install | 显示安装进度条,安装到默认路径 |
/not_create_desktop_shortcuts | 不创建用户工具桌面快捷方式,在 /S 模式下才能生效 |
/senseshield_hide_taskbar_icon | 隐藏用户工具托盘图标,在 /S 模式下才能生效 |
/add_ss_restart_schtask [--ss_restart_schtask_time=06:00:00] | 添加服务定时重启计划任务(不支持Windows XP 和 Windows Server 2003) |
注意
执行命令行参数过程中必须使用“管理员权限”运行,否则会提示“拒绝访问”。
查看命令参数示例:
集成安装包
这里将帮助您在您的安装包中集成打包 Virbox 用户工具,我们通过 NSIS、C代码、C#代码的例子来帮您自实现工具的打包安装。
NSIS 脚本
Function InstallSenseshield
;; 静默安装 Virbox 用户工具
; 打包 Virbox 用户工具安装包
File /oname=$TEMP\sense_shield_installer_pub.exe sense_shield_installer_pub.exe
; 获取当前 Virbox 用户工具文件版本号(用于判断是否执行安装)可忽略
${GetFileVersion} "$TEMP\sense_shield_installer_pub.exe" $R0
; (同步)后台执行安装过程
ExecWait '"$TEMP\sense_shield_installer_pub.exe" /S' $0
DetailPrint "sense_shield_installer_pub.exe $R0 return $0"
; 判断安装结果是否成功
IntCmp $0 0 0 ExitInstall ExitInstall
Return
ExitInstall:
; TODO 安装错误处理
FunctionEnd
C 代码示例
#include <stdio.h>
#include <Windows.h>
int main()
{
int ret = 0;
char *silent_install_cmd = "\"C:\\Program Files (x86)\\senseshield\\ss_dev\\Redistribute\\sense_shield_installer_pub.exe\" /S";
ret = system(silent_install_cmd);
switch (ret)
{
case 0:
printf("安装成功\n");
// 静默安装成功,在此处编写后续处理代码
break;
case 3:
printf("已安装版本高于当前版本\n");
break;
case 4:
printf("无法终止运行中进程,重启电脑后重新安装\n");
break;
case 5:
printf("安装文件丢失\n");
break;
case 6:
printf("x64系统驱动文件重命名失败\n");
break;
default:
printf("未知错误\n");
break;
}
getchar();
}
C# 代码示例
using System.Diagnostics;
namespace SSPubPackageSilentInstallDemo
{
class Program
{
static void Main(string[] args)
{
string package_path = @"C:\Program Files (x86)\senseshield\ss_dev\Redistribute\sense_shield_installer_pub.exe";
string silent_params = "/S";
Process process = Process.Start(package_path, silent_params);
process.WaitForExit();
switch (process.ExitCode)
{
case 0:
Console.WriteLine("安装成功\n");
// 静默安装成功,在此处编写后续处理代码
break;
case 3:
Console.WriteLine("已安装版本高于当前版本\n");
break;
case 4:
Console.WriteLine("无法终止运行中进程,重启电脑后重新安装\n");
break;
case 5:
Console.WriteLine("安装文件丢失\n");
break;
case 6:
Console.WriteLine("x64系统驱动文件重命名失败\n");
break;
default:
Console.WriteLine("未知错误\n");
break;
}
Console.ReadKey();
}
}
}
Linux 版
安装包版本
基于 Debian 软件包的 .deb 安装包,分 x86 和 x64 两个版本,可用于 Debian、Ubuntu 等系统。
基于 RPM 软件包管理器的 .rpm 安装包,分 x86 和 x64 两个版本。
安装方式
Linux 安装包相关详细命令如下:
rpm格式 (例 senseshield-2.2.0.31501.i386.rpm) | deb格式 (例 senseshield-2.2.0.31501-i386.deb) | 备注 | |
---|---|---|---|
注意 | 1 必须使用管理员权限进行安装/升级/覆盖/卸载等操作。 2 安装之前,要确定当前目录下存在安装包文件,输入ls命令查看即可。 如果不在,需要cd 命令切换到安装包文件所在目录。 | ||
安装 | rpm -ivh senseshield-2.2.0.31501.i386.rpm(带后缀) | dpkg -i senseshield-2.2.0.31501-i386.deb(带后缀) | root权限 |
升级 | rpm -Uvh 高版本的rpm安装包名字(带后缀) | dpkg -i高版本deb安装包名字(带后缀) | root权限 |
强制覆盖 | rpm -ivh --force 要安装的包名(带后缀) | dpkg -i要安装的包名(带后缀) | root权限 |
卸载 | rpm -e senseshield (不带后缀) | dpkg -P senseshield (不带后缀) | root权限 |
查看包信息 | rpm -qi senseshield (不带后缀) | dpkg -l senseshield (不带后缀) | 权限不限 |
其他 | 关于 rpm 和 dpkg命令的详细参数,可在系统下自行查看。查看命令如下: rpm --help dpkg --help |
安装完成后,使用查看服务状态命令查询状态,service senseshieldd status 或者 systemctl status senseshield,详见下文 Virbox 许可服务服务管理。
macOS 版
macOS 版本目前仅支持直接双击安装的方式,其他方式暂不支持。
小结
当环境部署完成后,就可以正常运行我们的软件了,详细介绍请看 下一节。