## iss 语法参考
[语法参考](https://blog.csdn.net/qq_41142992/article/details/139726536)

[语法使用参考](https://zhuanlan.zhihu.com/p/168690637)





## iss 文件结构
```
//宏定义段

[Setup]

[Types]

[Components]

[Tasks]

[Dirs]

[Files]

[Icons]

[INI]

[Languages]

[Messages]

[CustomMessages]

[LangOptions]

[Registry]

[Run]

[UninstallDelete]

[UninstallRun]

[Code]
```

## 安装顺序

```
[Dir]

[Files]

[Icons]

[INI]

[Registry]

[Run]（PS:对于使用Flags:postinstall的项需要特别注意）
```

## 常用语法

### 宏定义

宏定义即该脚本的全局变量

定义方式
```
#define MyAppName "MyApp"
#define MyVersion "3.2.5.872"
```

调用方式
```
{#MyAppName}
{#MyAppVersion}
```

### Setup 全局设置

```
[Setup]
//每个安装程序的AppId都不同，用于区分不同的程序
AppId={{E7388416-72E3-4077-9F1E-025AE6E5AAA1}
//应用程序名称
AppName={#MyAppName}
//应用程序版本
AppVersion={#MyAppVersion}
AppPublisher={#MyAppPublisher}
//默认安装路径，autopf 即当前用户的 programfiles 文件夹
DefaultDirName={autopf}\{#MyAppName}
//安装/卸载后刷新文件关联信息
ChangesAssociations=yes
//安装程序将不显示“选择开始菜单文件夹”向导页
DisableProgramGroupPage=yes
//安装包输出目录路径
OutputDir={#BasePath}\release\AppSetup_{#MyAppVersion}
//安装文件名称
OutputBaseFilename=AppV3ServerSetup_{#MyAppVersion}
//压缩算法，基于压缩率和压缩/解压缩速度权衡，推荐zip算法
Compression=zip
//是否启用固态压缩（将所有文件进行一次压缩，提升压缩率），默认no
SolidCompression=yes
//安装程序外观风格，默认classic 
WizardStyle=modern
//以管理员权限安装
PrivilegesRequired=admin
//对于安装包大小大于2,100,000,000 bytesd(2GB)的情况下，需要开启该选项，将生成一个setup.exe以及多个bin文件，分片
DiskSpanning=yes
//安装包的图标
SetupIconFile=E:\部署环境\app\server\256.ico
//鼠标悬浮-文件版本
VersionInfoVersion={#MyVersion}
//鼠标悬浮-公司信息
VersionInfoCompany={#MyCompany}
//鼠标悬浮-程序版本
VersionInfoProductVersion={#MyVersion}
//鼠标悬浮-程序名称
VersionInfoProductName={#MyProductName}
//鼠标悬浮-版权
AppCopyright={#MyAppCopyright}
```

### Types 安装类型 + Components 安装组件

#### Types

安装程序将显示在向导的选择组件页面上的所有安装类型，一般用于自定义安装，与`[Components]`配合使用

` Flags: iscustom` 表示该类型是自定义类型。

用户在安装过程中手动更改组件选择时，安装程序都会将安装类型设置为自定义类型。

如果不定义自定义类型，安装程序将只允许用户选择安装类型，他们不能再手动选择/取消选择组件。


```
[Types]
Name: "full"; Description: "完整安装所有组件"
Name: "onlyInstallServiceA"; Description: "仅安装服务A"
Name: "onlyInstallSeeviceB";Description:"仅安装服务B"; 
Name: "custom ";Description:"自定义安装组件"; Flags: iscustom
```

#### Components

这里的 Types 即上面定义过得 Types

```
[Components]
Name: "main"; Description: "系统运行的最小单元"; Types: full ; Flags: fixed
Name: "main\client"; Description: "服务A"; Types: onlyInstallServiceA custom; Flags: fixed
Name: "main\server"; Description: "服务B"; Types: onlyInstallServiceB custom; Flags: fixed
Name: "tools"; Description: "工具"; Types: full custom
Name: "tools\backups"; Description: "数据备份工具"; Types: full custom
Name: "tools\logs"; Description: "日志处理工具"; Types: full custom
```


![image.png](https://oss.silon.vip/img/7584d38f9d1b005575705a69ec7749fa.image.webp)


### 安装任务 Tasks

安装程序在安装过程中将执行的所有用户可选任务

相关参数：

`Components`: 关联的组件，只有用户在上一步选择了该组件，这一步才会展示该任务

`Flags`: 
  - exclusive : 是否其他任务互斥

```
[Tasks]
Name: "resetDateDir"; Description: "重新选择数据存储目录"; GroupDescription: "修改配置信息:";
Name: "autoBackupCases"; Description: "安装前自动备份案件数据"; GroupDescription: "案件数据:"; Components: tools\backups

Name: "restart"; Description: "安装完成后自动重启电脑"; Flags:exclusive 
Name: "autoOpenClient"; Description: "安装完成后自动打开客户端"; Flags:exclusive
```


### 创建目录 Dirs

安装程序除了用户选择的应用程序目录(该目录是自动创建的)之外要创建的任何其他目录

相关参数：

`Attribs`: 目录的其他属性
 - readonly, hidden, system, notcontentindexed

`Flags`:
- deleteafterinstall
    - 如果安装之前目录不存在，且安装完成(或中止)后目录为空，则在安装完成(或中止)后将其删除。

- uninsalwaysuninstall
    - 安装完成(或中止)后目录为空，则在安装完成(或中止)后将其删除。

- uninsneveruninstall
    - 卸载程序不删除目录。默认情况下，如果[ Dirs ]部分中指定的目录为空，卸载程序将删除该目录。


```
[Dirs]
Name: "{app}\data"; Attribs: readonly; Flags: "deleteafterinstall"
Name: "{app}\bin"
```

### 创建文件 Files

安装程序要安装在用户系统上的文件

相关参数：

`DestName`:
- 此参数指定文件在用户系统上安装时的新名称。默认情况下，安装程序使用 Source 参数中的名称，因此在大多数情况下不需要指定此参数。

`Excludes`:
- 指定要排除的模式列表，以逗号分隔。此参数不能与 external 组合。

```
Source: "{#BasePath}\jre\*"; DestDir: "{app}\jre"; Excludes: "*.txt"; Flags: ignoreversion recursesubdirs createallsubdirs
```

`Flags`
- confirmoverwrite: 在替换现有文件之前，始终要求用户确认。

- createallsubdirs: 默认情况下编译器在递归搜索 Source 文件名/通配符（例如 jre\*）时会跳过空目录。这个标志会在安装时创建这些目录，必须与recursesubdirs一起使用

- deleteafterinstall: 安装后删除，如果安装前文件存在，且未替换，则不删除，不能与isreadme, regserver, regtypelib, restartreplace, sharedfile， uninsneveruninstall一起使用

- dontverifychecksum: 安装程序在提取后,不验证文件校验和。对已编译到安装程序中但希望修改的文件使用此标志。与nocompression一起使用

- isreadme: 文件是“ README”文件。安装中只有一个文件可以有这个标志。当一个文件有这个标志时，会出现一个选项，是否希望在安装完成后查看 README 文件。如果选择“是”，安装程序将打开该文件。对文件后缀有要求.txt, .wri, .doc

- nocompression: 不进行压缩

- onlyifdoesntexist: 只有当文件在用户系统上不存在时才安装该文件。

- recursesubdirs: 递归Source指定的目录

- replacesameversion:用户的系统中已经存在该文件，并且版本号相同时，并且文件内容不同时，才替换该文件。PS:默认行为情况下，不替换具有相同版本号的现有文件。

- uninsneveruninstall:不删除文件


```
[Files]
Source: "D:\code\local\打包\abc.reg"; DestDir: "{app}"; Flags: ignoreversion
Source: "D:\code\local\打包\test.txt"; DestDir: "{app}"; Flags: ignoreversion
Source: "D:\code\local\打包\test.mp4"; DestDir: "{app}"; Flags: ignoreversion
```

### 注册表 Registry

用于在用户系统中创建，修改或删除注册表健值

```iss
[Registry]
Root: HKLM; Subkey: "Software\YourCompanyName\YourApplicationName"; ValueType: string; ValueName: "SomeValue"; ValueData: "SomeData"; Flags: uninsdeletevalue; MinVersion: 0,6.1
```

- `Root`指定了注册表项的根键
- `Subkey`指定了注册表项的路径
- `ValueType`指定了注册表值的类型
- `ValueName`指定了注册表值的名称
- `ValueData`指定了注册表值的数据
- `Flags`指定了卸载时是否删除该注册表值
- `MinVersion`指定了最低支持的Inno Setup版本


| Root | 注册表Root key |
| --- | --- |
| HKCU	| (HKEY_CURRENT_USER)
| HKLM	| (HKEY_LOCAL_MACHINE)
| HKCR	| (HKEY_CLASSES_ROOT)
| HKU	| (HKEY_USERS)
| HKCC	| (HKEY_CURRENT_CONFIG)
| HKA	| 在管理员权限运行时为HKLM，否则为HKCU


| ValueType |	注册表   |
| --- | --- |
| none	| 创建键，但不创建值
| string |	REG_SZ
| expandsz |	REG_EXPAND_SZ
| multisz |	REG_MULTI_SZ
| dword |	REG_DWORD
| qword |	REG_QWORD
| binary |	REG_BINARY


## 实用示例

### 创建注册表

创建一个注册表，并修改里面的键值对
```iss
[Registry]

Root: HKLM; Subkey: "SOFTWARE\Demo"; Flags: uninsdeletekeyifempty
Root: HKLM; Subkey: "SOFTWARE\Demo"; ValueType: dword; ValueName: "LOADCTRLS"; ValueData: $00000002; Flags: uninsdeletevalue
Root: HKLM; Subkey: "SOFTWARE\Demo"; ValueType: string; ValueName: "DESCRIPTION"; ValueData: "xxxx模块"; Flags: uninsdeletevalue
```

### 安装时创建指定文件

举例：安装时，创建一个文件，内容为当前系统用户的默认下载路径

```iss
[Code]
function GetUsername: String;
begin
  Result := ExpandConstant('{%USERNAME}');
end;

procedure WriteProfileIni;
var
  ProfileContent: TStringList;
begin
  ProfileContent := TStringList.Create;
  try
    ProfileContent.Add('CurrentUserDownloadPath = "C:\Users\' + GetUsername + '\Downloads"');
    ProfileContent.SaveToFile(ExpandConstant('{app}\profile.ini'));
  finally
    ProfileContent.Free;
  end;
end;

procedure CurStepChanged(CurStep: TSetupStep);
begin
  if CurStep = ssPostInstall then
  begin
    WriteProfileIni;
  end;
end;
```

### 卸载时删除指定文件

此处 `{app}` 为安装目录，打包程序能够自动识别
```iss
[UninstallDelete]
Type: filesandordirs; Name: "{app}\profile.ini"
```

inno setup 语法及进阶

## 下载inno setup 安装包

https://jrsoftware.org/isdl.php#stable


![image.png](https://oss.silon.vip/img/f049f97e11552d0760e60aee50fd89e6.image.webp)





一路安装即可

安装后会自动打开


![image.png](https://oss.silon.vip/img/48a876ec5eaa3433ec495393c93a73be.image.webp)

## 准备语言包

点击官网左侧的Translations按钮，在下面找到Chinese (Simplified)


![image.png](https://oss.silon.vip/img/1f62b1ff5a35e56d2c9c77f658229e6e.image.webp)

右键下载列，进行下载

![image.png](https://oss.silon.vip/img/f19e7d3fb3eb119aece897ba0e5a4304.image.webp)

将下载的文件放置在 inno setup 安装目录下的 language 文件夹中


![image.png](https://oss.silon.vip/img/953b5361ccd69eccdf9735ad22b95721.image.webp)

这样，我们就能做出中文的安装包

## 开始打包

### 新建打包项目

点击新建


![image.png](https://oss.silon.vip/img/1023128bfe9eac47ccf8a2be32c39e79.image.webp)

点击next，填写软件的基本信息


![image.png](https://oss.silon.vip/img/bee3789b09872d438e8bd24d4ffa57d1.image.webp)


![image.png](https://oss.silon.vip/img/e78e5766c5f78f6bbeef5be0860404b8.image.webp)


![image.png](https://oss.silon.vip/img/9f275dff3ca4bd360ee770d418b19d7b.image.webp)


![image.png](https://oss.silon.vip/img/ae209038dff49bf9c9bf46de4a0b9e0c.image.webp)


![image.png](https://oss.silon.vip/img/cd572e685c4ae55f2040a56f7a7dba9f.image.webp)


![image.png](https://oss.silon.vip/img/0c25e6afaf260a7ab656061e72658768.image.webp)


![image.png](https://oss.silon.vip/img/b7d3a0ef961128053ca9e595978b5395.image.webp)


![image.png](https://oss.silon.vip/img/847fa39ddfaf5f67f64a5f688cbea97b.image.webp)


![image.png](https://oss.silon.vip/img/d176792711b2f3c97aa03841684a9cbb.image.webp)


![image.png](https://oss.silon.vip/img/6960fcd6c7f49e4276fb7b658f03fe43.image.webp)

一路完成即可


![image.png](https://oss.silon.vip/img/8d0ff57a688866f091655ed1c04b7275.image.webp)

是否立即编译脚本生成安装包

![image.png](https://oss.silon.vip/img/866ba9790530a57a3d79bda7d96349fc.image.webp)


![image.png](https://oss.silon.vip/img/6f9090d43ebe8fc3a90ec06f6e1b3178.image.webp)

这里保存的是 inno setup 编辑文件，自定义保存位置后，就开始编译了
![image.png](https://oss.silon.vip/img/f354a05b2ce928018fec9507c1fd4bd2.image.webp)

等待下面输出成功字样说明安装包生成完毕
![image.png](https://oss.silon.vip/img/b1735ff95a674ff74131d9eeb142d362.image.webp)


## 常见问题
1. 安装程序运行正常，但是注册表没有执行成功  
   原因：
   
   安装程序可能会以 32 位模式运行，导致无法正确访问或修改 64 位系统的注册表项  
   
   
   解决方法：
   
   如果您的安装程序需要访问或修改 64 位系统的注册表项，那么需要确保安装程序以 64 位模式运行，才能正确访问和修改 64 位系统的注册表
   
   可以在.iss文件中， [Setup] 中添加一个配置项   
   ```iss
   ArchitecturesInstallIn64BitMode=x64compatible
   ```

inno setup 打包exe应用

## 注册geoip账号

https://www.maxmind.com/

完成登录后，创建 lisence key

![image.png](https://oss.silon.vip/img/9f57adff6f3cfed9eaa24d6731bc4f81.image.webp)




![image.png](https://oss.silon.vip/img/e44f60dcfd360ae5f25b8590c6f89066.image.webp)

## 更新 Sentry 配置

在`geoip`文件夹中编辑 `GeoIP.conf`

只根据创建的内容修改前两项即可

```conf
AccountID xxxxx
LicenseKey xxxxxx
EditionIDs GeoLite2-City
```

## 完成更新

```
./install.sh

docker compose up -d
```


![image.png](https://oss.silon.vip/img/9fcecbccfbf72608b45d137d6062338c.image.webp)

Sentry 配置Geoip

## 相关官方文档

https://develop.sentry.dev/self-hosted/email/

https://develop.sentry.dev/services/email/





## 提前准备内容

1. 一个邮箱账号，我这里使用163邮箱
2. 在邮箱内配置授权码
![image.png](https://oss.silon.vip/img/d64cf6bc6a2ef0da29d7f3d21e4f4bc2.image.webp)
![image.png](https://oss.silon.vip/img/7f7f29076de8c905eb0bf890eb4ffdab.image.webp)


## 配置流程

在sentry项目下 `sentry/config.yml`中

找到并修改以下项目

```yml
###############
# Mail Server #
###############
# 邮箱服务类型
mail.backend: 'smtp'  # Use dummy if you want to disable email entirely
# 邮箱服务端地址
mail.host: 'smtp.163.com'
# 使用的协议， smtp 可以使用 25， 465（ssl）， 487（tsl）
mail.port: 465
# 你自己的邮箱地址和授权码，注意这里不是登录密码
mail.username: 'silon_j@163.com'
mail.password: 'xxxxxxxxxxxx'

# sentry发送邮件显示的发件人，同你的邮箱即可
mail.from: 'silon_j@163.com'

# 是否使用tls或ssl
# mail.use-tls: false
mail.use-ssl: true

# 你的sentry 运行的域名
mail.list-namespace: 'sentry.xxx.xxx'

```


:::warning{title="注意"}
如果你使用阿里云搭建sentry服务，则上面的配置不能填写 25端口，因为阿里云官方限制25端口出口

即使通过服务器自行配置出入防火墙都无效，需要向阿里云官方申请

详情可见：
https://developer.aliyun.com/article/1531784?spm=5176.26934566.main.2.479d7d71VXIvik
:::

## 重启服务

返回sentry 根目录，重启服务即可

```
./install.sh
```

## 测试邮件效果 

点击测试，反馈发送成功即为配置成功
![image.png](https://oss.silon.vip/img/f66056a67896bad4507937b9745953f0.image.webp)


![image.png](https://oss.silon.vip/img/fee9bf5710eb4d4b9f950370beddbcb5.image.webp)

Sentry 邮箱配置


## 创建新账户：

执行以下命令创建一个名为"newuser"的账户，并设置密码为"123456"：

`%` 表示不限制用户登录的ip
如果只希望用户从本机登录，可以更改为`localhost`

```sql
CREATE USER 'newuser'@'%' IDENTIFIED BY '123456';
```


## 授予数据库访问权限：

执行以下命令授予"newuser"账户对"app"数据库的访问和操作权限：
```sql
GRANT ALL PRIVILEGES ON app.* TO 'newuser'@'%';
```


## 刷新权限
执行以下命令以使更改生效：
```sql
FLUSH PRIVILEGES;
```
