2.9. 注册和使用许可证
内容
2.9.1. 前提条件
在注册许可证之前，需要满足下列条件
2.9.2. 使用基础版和专家版许可证
基本使用步骤：
2.9.2.1. 初始登记
在第一次注册的时候，需要使用 -p 指定许可证绑定的产品名称，如果在非商业化产品中的使用 Pyarmor，那么产品名称设定为 non-profits ，该许可证不能被应用于商用产品中。
假设许可证绑定的产品名称为 XXX ，那么使用下面的命令进行初始登记注册:
$ pyarmor reg -p "XXX" pyarmor-regcode-xxxx.txt
Pyarmor 会首先显示注册信息并请求确认，如果确认无误，输入 yes 并 Enter 继续下面的注册步骤，其他任何输入都会终止注册过程。
登记成功之后会同时生成一个相应的 注册文件 pyarmor-regfile-xxxx.zip ，这个文件被用来在其他设备上进行注册。
请不要再次使用 激活文件 进行后续的注册，在初始登记之后这个文件失效，后续在任何设备上注册请使用 注册文件 。
请妥善保管并备份注册文件，一旦丢失，Pyarmor 并不提供找回服务。
一旦登记成功，许可证绑定的产品名称就不能在进行修改。
2.9.2.2. 绑定许可证到正在开发的产品
如果产品还在开发中，没有正式开始销售，允许初始化登记的时候设定产品的名称为 TBD 。例如:
$ pyarmor reg -p "TBD" pyarmor-regcode-xxxx.txt
绑定的产品名称为 TBD 的许可证，必须在六个月之内，使用下面的命令设置为正确的产品名称:
$ pyarmor reg -p "XXX" pyarmor-regcode-xxxx.txt
如果六个月之内还没有进行修改，那么产品名称会被自动设定为 non-profits ，并且不能在被修改。
2.9.2.3. 在其他设备上面注册
拷贝 注册文件 pyarmor-regfile-xxxx.zip 到其他需要注册的设备，然后运行下面的命令进行注册:
$ pyarmor reg pyarmor-regfile-xxxx.zip
查看注册信息:
$ pyarmor -v
注册成功之后所有的加密操作自动应用当前许可证，每一次加密操作需要联网验证许可证。
2.9.2.4. 在 Docker 或者 CI pipeline 中注册
在 Docker 或者 CI pipeline 中注册 Pyarmor 的基本方法同上，但是同时运行的 Pyarmor 的 Docker 数量有限制，不能超过 100 个。
只允许在开发设备上安装和注册 Pyarmor。如果 Docker 镜像需要发送给客户，那么不允许在上面安装和注册 Pyarmor
2.9.3. 使用集团版许可证
在 8.2 版本加入.
每一个集团版许可证称为一个组，一个组最多可以有 100 个离线设备，每一个设备有一个编号，依次从 1 到 100。
必须依次为离线设备进行编号，例如第一台设备编号为 1 ，第二台设备为 2 等等。
基本使用步骤：
在离线设备上生成相应的组设备文件
在联网设备上面使用 注册文件 和组设备文件生成离线注册文件
在离线设备上使用离线注册文件进行注册，离线注册文件只能在绑定的设备上使用
2.9.3.1. 初始登记
购买集团版许可证之后，一个 pyarmor-regcode-xxxx.txt 的 激活文件 会发送到注册邮箱中，这个文件用于第一次的注册登记。
集团版许可证的初始登记也需要在有网络的设备上进行，初始登记必须指定许可证绑定的产品名称，这里不允许使用 TBD 。假设产品名称是 XXX ，运行下面的命令进行初始登记:
$ pyarmor reg -p XXX pyarmor-regcode-xxxx.txt
登记成功之后会生成相应的 注册文件 pyarmor-regfile-xxxx.zip ，这个注册文件可用于后续的注册命令。
2.9.3.2. 生成组设备文件
为了在离线设备上注册 Pyarmor，首先需要生成设备对应的组设备文件 pyarmor-group-device.X ，其中 X 是设备编号。
在每一台离线设备上安装 Pyarmor ，使用选项 -g 指定设备编号，生成相应的设备文件。
例如，在第一台离线设备上，运行下面的命令生成组设备文件 pyarmor-group-device.1:
$ pyarmor reg -g 1
2.9.3.3. 生成离线设备注册文件
生成离线设备注册文件需要
安装 Pyarmor 8.2+ 并且可以访问互联网的设备
完成初始登记，并且已经生成 注册文件
pyarmor-regfile-xxxx.zip离线设备的组设备文件
把离线设备的组设备文件拷贝到进行初始登记的机器上，并存放在当前目录下面的子目录 .pyarmor/group/ ，然后使用下面的命令生成离线注册文件 pyarmor-device-regfile-xxxx.1.zip:
$ mkdir -p .pyarmor/group
$ cp pyarmor-group-file.1 .pyarmor/group/
$ pyarmor reg -g 1 /path/to/pyarmor-regfile-xxxx.zip
这条命令生成的离线注册文件只可以在第一台设备上使用。
2.9.3.4. 离线设备注册
一旦生成离线设备注册文件之后，就可以拷贝到离线设备上面进行注册。例如，在第一台离线设备上，运行下面的命令:
$ pyarmor reg pyarmor-device-regfile-xxxx.1.zip
查看注册信息:
$ pyarmor -v
注册成功之后所有的加密操作自动应用集团版许可证，注册和加密都不需要联网验证。
2.9.3.5. 支持多设备的离线注册文件
在 8.x 版本加入: 该功能尚未实现
如果需要为所有设备生成一个集成的离线注册文件，首先把所有组设备文件拷贝到指定目录，然后使用特殊组号 0 生成所有设备可用的离线注册文件 pyarmor-device-regfile-xxxx.zip:
$ cp pyarmor-group-file.1 pyarmor-group-file.2 pyarmor-group-file.3 .pyarmor/group/
$ pyarmor reg -g 0 /path/to/pyarmor-regfile-xxxx.zip
然后拷贝到每一台离线设备，使用 -g 指定设备编号进行注册:
$ pyarmor reg -g 1 pyarmor-device-regfile-xxxx.zip
2.9.4. 升级老版本许可证
升级老版本的许可证请参考 升级老版本许可证