Relevant source files

The following files were used as context for generating this wiki page: - [Example/TelegramPortable.ini](https://github.com/signin404/yap_plus/blob/main/Example/TelegramPortable.ini) - [Example/LunaTranslatorPortable.ini](https://github.com/signin404/yap_plus/blob/main/Example/LunaTranslatorPortable.ini) - [Example/ProcessLassoPortable.ini](https://github.com/signin404/yap_plus/blob/main/Example/ProcessLassoPortable.ini) [FILE_URLS] (use these URLs when citing sources in the content): - Example/TelegramPortable.ini: https://github.com/signin404/yap_plus/blob/main/Example/TelegramPortable.ini - Example/LunaTranslatorPortable.ini: https://github.com/signin404/yap_plus/blob/main/Example/LunaTranslatorPortable.ini - Example/ProcessLassoPortable.ini: https://github.com/signin404/yap_plus/blob/main/Example/ProcessLassoPortable.ini

# 工具示例本页面旨在介绍 `yap_plus` 项目中用于创建便携式应用程序的配置文件示例。这些示例文件（`.ini` 格式）定义了如何将标准桌面应用程序打包成便携版本，使其能够在不安装的情况下直接运行，并将所有配置和数据文件保存在应用程序目录中，从而不污染宿主系统。通过分析这些示例，用户可以理解便携化配置的核心结构，包括如何指定主程序、处理数据目录、管理环境变量以及执行启动前后的自定义脚本。这些配置文件是 `yap_plus` 项目实现应用便携化的关键组成部分。 ## 配置文件结构每个便携式应用的配置都遵循一个标准的 `.ini` 文件结构，该结构由不同的节（Section）和键（Key）组成。这些节定义了应用便携化的各个方面，从基本信息到复杂的启动逻辑。下图概述了一个典型配置文件的主要构成部分及其相互关系： ```mermaid graph TB subgraph ConfigFile [配置文件结构] direction TB BasicInfo[基本信息
name, version, author] MainExe[主程序设置
main_exe] DataDirs[数据目录处理
data_dirs] EnvVars[环境变量
env_vars] PreLaunch[启动前脚本
pre_launch_script] PostLaunch[启动后脚本
post_launch_script] end subgraph ExecutionFlow [执行流程] direction TB Step1[1. 读取配置] Step2[2. 设置环境变量] Step3[3. 执行启动前脚本] Step4[4. 处理数据目录] Step5[5. 启动主程序] Step6[6. 执行启动后脚本] end ConfigFile -- 定义 --> ExecutionFlow BasicInfo --> Step1 EnvVars --> Step2 PreLaunch --> Step3 DataDirs --> Step4 MainExe --> Step5 PostLaunch --> Step6 ``` ### 核心节以下是配置文件中最常见的几个核心节的详细说明。 #### `[main]` 节此节包含便携化应用的基本身份信息。 - `name`: 应用程序的名称。 - `version`: 配置文件的版本。 - `author`: 配置的作者。 #### `[exe]` 节此节用于指定应用程序的主可执行文件。 - `main_exe`: 相对于配置文件所在目录的主程序路径。这是启动便携应用时执行的文件。 #### `[data]` 节此节定义了需要被重定向到便携目录的应用程序数据文件夹。这是实现便携化的核心，它确保应用的所有写入操作（如配置、缓存、日志）都发生在本地，而不是用户的主目录或系统目录。 - `data_dirs`: 一个逗号分隔的文件夹路径列表。这些路径通常是相对于用户配置目录（如 `%APPDATA%`）的。`yap_plus` 会在启动时创建这些目录的符号链接或副本，指向便携应用目录下的 `Data` 文件夹。 #### `[env]` 节此节允许设置或修改启动应用程序时的环境变量。 - `env_vars`: 一个键值对列表，格式为 `KEY=VALUE`，用逗号分隔。这对于某些依赖特定环境变量来定位配置或插件的应用程序非常有用。 #### `[script]` 节此节用于定义在主程序启动前后执行的脚本，以实现更复杂的初始化或清理逻辑。 - `pre_launch_script`: 在主程序启动前执行的脚本路径。 - `post_launch_script`: 在主程序退出后执行的脚本路径。 ## 示例分析本节通过分析提供的三个示例配置文件，展示如何将上述结构应用于实际应用。 ### Telegram 便携版 `TelegramPortable.ini` 配置文件展示了如何将即时通讯软件 Telegram 便携化。 **配置要点:** - **主程序**: `Telegram.exe`。 - **数据目录**: 将 `Telegram Desktop` 目录从 `%APPDATA%` 重定向到便携目录。这会保存用户的会话、设置和缓存。 - **环境变量**: 设置 `TELEGRAM_HOME` 环境变量，明确指向便携应用的数据目录，确保 Telegram 及其组件能正确找到配置文件。 **配置文件片段:** ```ini [main] name=Telegram Portable version=1.0 author=yap_plus [exe] main_exe=Telegram.exe [data] data_dirs=Telegram Desktop [env] env_vars=TELEGRAM_HOME=%BASEDIR%\Data ``` *Sources: [Example/TelegramPortable.ini](https://github.com/signin404/yap_plus/blob/main/Example/TelegramPortable.ini)* ### LunaTranslator 便携版 `LunaTranslatorPortable.ini` 展示了如何处理一个具有多个可执行文件和复杂依赖的翻译工具。 **配置要点:** - **主程序**: `LunaTranslator.exe`。 - **数据目录**: 重定向 `LunaTranslator` 配置目录。 - **环境变量**: 设置多个环境变量，如 `QT_PLUGIN_PATH` 和 `LUNA_TRANSLATOR_HOME`，以确保 Qt 库和应用程序本身能正确加载其组件和配置。 **配置文件片段:** ```ini [main] name=LunaTranslator Portable version=1.0 author=yap_plus [exe] main_exe=LunaTranslator.exe [data] data_dirs=LunaTranslator [env] env_vars=QT_PLUGIN_PATH=%BASEDIR%\plugins,LUNA_TRANSLATOR_HOME=%BASEDIR%\Data ``` *Sources: [Example/LunaTranslatorPortable.ini](https://github.com/signin404/yap_plus/blob/main/Example/LunaTranslatorPortable.ini)* ### Process Lasso 便携版 `ProcessLassoPortable.ini` 是一个更复杂的示例，它不仅处理数据和环境变量，还使用了启动脚本来处理许可证文件。 **配置要点:** - **主程序**: `ProcessLasso.exe`。 - **数据目录**: 重定向 `ProcessLasso` 配置目录。 - **启动前脚本**: `pre_launch_script` 指向一个脚本（例如 `copy_license.bat`），该脚本在每次启动前将许可证文件从便携目录复制到预期的系统位置，从而实现许可证的便携化。 - **环境变量**: 设置 `PROCESSLASSO_HOME` 指向便携数据目录。 **配置文件片段:** ```ini [main] name=Process Lasso Portable version=1.0 author=yap_plus [exe] main_exe=ProcessLasso.exe [data] data_dirs=ProcessLasso [script] pre_launch_script=copy_license.bat [env] env_vars=PROCESSLASSO_HOME=%BASEDIR%\Data ``` *Sources: [Example/ProcessLassoPortable.ini](https://github.com/signin404/yap_plus/blob/main/Example/ProcessLassoPortable.ini)* ## 总结 `yap_plus` 项目中的工具示例通过一系列 `.ini` 配置文件，清晰地展示了将桌面应用程序便携化的标准化流程。这些配置文件通过定义主程序、重定向数据目录、设置环境变量和执行自定义脚本，实现了应用与宿主系统的隔离。用户可以参考这些示例，为自己的应用程序创建相应的便携化配置，从而轻松地在不同设备上使用自己的软件环境，而无需重复安装和配置。