## 问题说明

vite 中已经配置了 @ 路径
```ts
  resolve: {
    alias: {
      '@': resolve(__dirname, "./src"),
    }
  }
```
并且路径已经可以识别，但是编辑器提示ts无法识别

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

## 解决方法

修改ts检查配置，找到tsconfig.json 或其引用的配置文件，对 `compilerOptions` 项中添加`path`配置

```
"compilerOptions": {
    /* 项目自定义配置 */
    "paths": {
      "@/*": ["./src/*"]
    },
}
```

vite 中设置@ 路径，ts报错 2307

## 解决办法：

1、在github desktop中，点击"File"-"Options"；

2、在弹出的页面中，点击左侧的"Git"；

3、在"Git"对应的右侧，点击"edit your global Git config file."；





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

4、在打开的.gitconfig文件中，增加如下内容

```
[core]
autocrlf = false
```

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


5、回到弹出页面，点击"Save"


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

github desktop 提示This diff contains a change in line endings from ‘LF‘ to ‘CRLF‘.

## 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)