Cocos2dx 编译游戏安装包制作教程

如果皮卡会coding2024-06-15 20:51

在 Visual Studio 项目中配置图标并使用 Inno Setup 创建安装包

在本教程中，我们将学习如何为 Visual Studio 编译项目配置图标，并使用 Inno Setup 创建安装包。教程包括以下部分：

  1. 设置项目图标：在 Visual Studio 中配置 .exe 文件的图标，或者使用第三方工具替换编译后的图标。
  2. 创建安装包：使用 Inno Setup 编写脚本，创建安装包。

除了Inno Setup之外，还可以使用NSIS、Enigma Virtual Box。

文章目录

  • [在 Visual Studio 项目中配置图标并使用 Inno Setup 创建安装包](#在 Visual Studio 项目中配置图标并使用 Inno Setup 创建安装包)
    • [1. 设置项目图标（默认为 Cocos Logo 可跳过）](#1. 设置项目图标（默认为 Cocos Logo 可跳过）)
      • [1.1 方法1：在 Visual Studio 中设置 .exe 文件的图标（编译前）](#1.1 方法1：在 Visual Studio 中设置 .exe 文件的图标（编译前）)
      • [1.2 方法2：使用第三方工具替换 .exe 文件的图标（编译后）](#1.2 方法2：使用第三方工具替换 .exe 文件的图标（编译后）)
    • [2. 创建安装包](#2. 创建安装包)
      • [2.1 Inno Setup 脚本说明](#2.1 Inno Setup 脚本说明)
      • [2.2 完整脚本实现](#2.2 完整脚本实现)
      • [2.3 构建运行](#2.3 构建运行)
    • [3. 阶段性小结](#3. 阶段性小结)
    • [4. 进一步兼容尝试](#4. 进一步兼容尝试)
      • [4.1 缺啥补啥](#4.1 缺啥补啥)
      • [4.2 辅助方法：使用 Dependency Walker 分析依赖项](#4.2 辅助方法：使用 Dependency Walker 分析依赖项)
      • [4.3 其他方法（理论上可行，若前文依旧无法解决可考虑）](#4.3 其他方法（理论上可行，若前文依旧无法解决可考虑）)
    • [5. 总结](#5. 总结)

1.1 方法1：在 Visual Studio 中设置 .exe 文件的图标（编译前）

  1. 准备图标文件 ：

    确保你有一个 .ico 格式的图标文件。如果你的图标是 .png 格式，可以使用在线工具或图像编辑软件将其转换为 .ico 格式。

  2. 添加图标资源 ：

    切换到资源视图之后，右键项目名 -> 添加 -> 资源：

    在添加资源中选择 Icon，导入：

    切换文件类型后，选择项目 Resource 内的 favicon.ico 文件即可：

    双击导入的 icon，页面如下：

  3. 启动编译，确认 ico ：

    重新清理解决方案，启动编译之后，确认编译文件夹下的 exe 文件是否不再是原 Cocos 的 logo：

1.2 方法2：使用第三方工具替换 .exe 文件的图标（编译后）

如果你已经编译好 .exe 文件并希望在编译后设置执行程序的 logo，可以使用第三方工具替换图标。

例如，可以使用 Resource Hacker 替换图标，这里给出一个思路（未尝试）。

2. 创建安装包

使用 Inno Setup 创建安装包，包含自定义安装包的图标、应用名称和安装路径。

下载地址：Inno Setup 官方网站

进入官方网站后点击下载即可：点击下载

下载安装后新建一个空脚本（.iss 文件），进行如下操作。

2.1 Inno Setup 脚本说明

我们基于以下内容作为示例：

  • 游戏编译文件夹路径为 E:\cocos\IceHockey\proj.win32\Release.win32
  • 图标路径为 E:\cocos\IceHockey\proj.win32\Release.win32\Resources\favicon.ico
  • 游戏名称是"冰球大作战"
  • 编译后的可执行文件名是 IceHockey.exe

首先，在脚本顶部定义参数：

bash 复制代码 
#define MyAppName "冰球大作战"
#define MyAppVersion "1.0"
#define MyAppSource "E:\cocos\IceHockey\proj.win32\Release.win32"
#define MyAppExeName "IceHockey.exe"
#define MyAppIcon "E:\cocos\IceHockey\proj.win32\Release.win32\Resources\favicon.ico"
  • MyAppName：应用程序的名称，将显示在安装向导和快捷方式中。
  • MyAppVersion：应用程序的版本号。
  • MyAppSource：游戏编译后的输出目录路径，包含可执行文件和资源文件。
  • MyAppExeName：应用程序的可执行文件名称。
  • MyAppIcon：应用程序的图标文件路径，将用于安装包和快捷方式图标。

在脚本部分相关配置如下：

  • [Setup] 部分：

    • AppName：安装程序显示的应用名称。
    • AppVersion：安装程序显示的应用版本。
    • DefaultDirName：应用程序的默认安装目录。
    • DefaultGroupName：开始菜单中的程序组名称。
    • OutputBaseFilename：生成的安装包文件名。
    • Compression 和 SolidCompression：安装包的压缩选项。
    • SetupIconFile：安装程序的图标文件。

  • [Files] 部分：

    • Source 和 DestDir：定义要打包的文件及其目标目录。
    • Flags: ignoreversion：忽略文件版本检查。
    • recursesubdirs：递归包含子目录中的所有文件。

  • [Icons] 部分：

    • Name：快捷方式名称和位置。
    • Filename：快捷方式指向的可执行文件。
    • IconFilename：快捷方式使用的图标文件。

2.2 完整脚本实现

根据模板生成完整的 Inno Setup 脚本（.iss 文件）：

bash 复制代码 
#define MyAppName "冰球大作战"
#define MyAppVersion "1.0"
#define MyAppSource "E:\cocos\IceHockey\proj.win32\Release.win32"
#define MyAppExeName "IceHockey.exe"
#define MyAppIcon "E:\cocos\IceHockey\proj.win32\Release.win32\Resources\favicon.ico"

[Setup]
; 安装程序信息
AppName={#MyAppName}
AppVersion={#MyAppVersion}
DefaultDirName={pf}\{#MyAppName}
DefaultGroupName={#MyAppName}
OutputBaseFilename={#MyAppName}Setup
Compression=lzma
SolidCompression=yes
SetupIconFile={#MyAppIcon}

[Files]
; 将所有游戏文件添加到安装包
Source: "{#MyAppSource}\{#MyAppExeName}"; DestDir: "{app}"; Flags: ignoreversion
Source: "{#MyAppSource}\*.dll"; DestDir: "{app}"; Flags: ignoreversion
Source: "{#MyAppSource}\Resources\*"; DestDir: "{app}\Resources"; Flags: ignoreversion recursesubdirs

[Icons]
; 创建桌面快捷方式
Name: "{group}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"
Name: "{commondesktop}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"

; [Run]
; 安装完成后自动运行游戏
; Filename: "{app}\{#MyAppExeName}"; Description: "{cm:LaunchProgram,{#MyAppName}}"; Flags: nowait postinstall skipifsilent

此时页面如下：

2.3 构建运行

随后点击构建中的编译或运行（Run），进行安装后测试游戏是否可以直接打开运行：

在我们安装 Inno Setup 6 的 output 目录中，即可看到我们的安装包：

点击后效果如下：

最终生成的页面图标如下：

3. 阶段性小结

通过上述步骤，即可在 Visual Studio 项目中设置 .exe 文件的图标，并使用 Inno Setup 创建包含自定义图标和安装路径的安装包。

至此即实现了 Cocos2d-x 游戏打包，我们可以发给其他游戏开发课程的同学了。

(blog over)

4. 进一步兼容尝试

4.1 缺啥补啥

如果发给没有配置 Visual Studio 环境的电脑，如缺失 Microsoft Visual C++ Redistributable packages、Windows SDK 10.0.17763.0 的机房电脑，依旧运行不起来：

经尝试，找到电脑中此 DLL 文件后放入打包目录中一起打包，则会出现下一个 DLL 文件缺失：

递归两三轮的实践后，发现一共缺失如下：

  • MSVCP140.DLL
  • MSVCR120.dll
  • MSVCR110.dll
  • VCRUNTIME140.DLL
  • VCRUNTIME140D.dll
  • ucrtbased.dll

推荐下载 Everything（速度快）搜索，一般在如下地址也能找到：

  • C:\Windows\System32
  • xx\Microsoft Visual Studio\2022(版本)\Community\VC\Redist\...
  • C:\Program Files (x86)\Windows Kits\10\bin\10.xxx(SDK 版本)

更新后的脚本如下（或者不更新脚本，将其移入MyAppSource文件夹内即可）：

bash 复制代码 
#define MyAppName "冰球大作战"
#define MyAppVersion "1.0"
#define MyAppSource "E:\cocos\IceHockey\proj.win32\Release.win32"
#define MyAppExeName "IceHockey.exe"
#define MyAppIcon "E:\cocos\IceHockey\proj.win32\Release.win32\Resources\favicon.ico"
; 缺啥补啥
#define VcRunTime "C:\windows\system32\VCRUNTIME140.DLL"
#define MSVCP140 "C:\windows\system32\MSVCP140.DLL"
#define MSVCR120 "C:\windows\system32\MSVCR120.DLL"
#define MSVCR110 "C:\windows\system32\MSVCR110.DLL"
#define WindowsKitsDir "C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0"
#define System32Dir "C:\Windows\System32"
#define UCRTDir "C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x86\ucrt"

[Setup]
; 安装程序信息
AppName={#MyAppName}
AppVersion={#MyAppVersion}
DefaultDirName={pf}\{#MyAppName}
DefaultGroupName={#MyAppName}
OutputBaseFilename={#MyAppName}-only-Denpendency
Compression=lzma
SolidCompression=yes
SetupIconFile={#MyAppIcon}

[Files]
; 将所有游戏文件添加到安装包
Source: "{#MyAppSource}\{#MyAppExeName}"; DestDir: "{app}"; Flags: ignoreversion
Source: "{#MyAppSource}\*.dll"; DestDir: "{app}"; Flags: ignoreversion
Source: "{#MyAppSource}\Resources\*"; DestDir: "{app}\Resources"; Flags: ignoreversion recursesubdirs
; 添加缺失的依赖文件
Source: "{#VcRunTime}"; DestDir: "{app}"; Flags: ignoreversion
Source: "{#MSVCP140}"; DestDir: "{app}"; Flags: ignoreversion
Source: "{#MSVCR120}"; DestDir: "{app}"; Flags: ignoreversion
Source: "{#MSVCR110}"; DestDir: "{app}"; Flags: ignoreversion
; 添加 Windows Kits 目录下的所有 DLL 文件
; Source: "{#WindowsKitsDir}\*.dll"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs
; 添加 System32 目录下的所有 DLL 文件
; Source: "{#System32Dir}\*.dll"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs
; 添加 ucrtbased.dll 文件
Source: "{#UCRTDir}\ucrtbased.dll"; DestDir: "{app}"; Flags: ignoreversion
; 添加 vcruntime140d.dll 文件
Source: "{#System32Dir}\vcruntime140d.dll"; DestDir: "{app}"; Flags: ignoreversion

[Icons]
; 创建桌面快捷方式并使用自定义图标
Name: "{group}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"; IconFilename: "{#MyAppIcon}"
Name: "{commondesktop}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"; IconFilename: "{#MyAppIcon}"

[Run]
; 安装完成后自动运行游戏
Filename: "{app}\{#MyAppExeName}"; Description: "{cm:LaunchProgram,{#MyAppName}}"; Flags: nowait postinstall skipifsilent

经实践，此时打包安装后可成功运行！

(blog over again)

4.2 辅助方法：使用 Dependency Walker 分析依赖项

根据 bug 搜集对应的 dll 文件多少有点被动。

理论上，使用 Dependency Walker 分析依赖项，可以提前知道所有需要包含的 DLL 文件以及对应的文件。

  1. 下载并安装 Dependency Walker。
  2. 打开你的可执行文件（例如 FinalGame.exe）。
  3. Dependency Walker 会显示所有依赖的 DLL 文件。右键 show full path，记录所有需要的文件，然后将它们添加到 Inno Setup 脚本中。

（PS：这个软件使用分析依赖项的时候特别卡，体验极差。）

4.3 其他方法（理论上可行，若前文依旧无法解决可考虑）

手动逐一添加 DLL 文件虽然可以最轻量地解决问题，但或许并不是最优雅和高效的方法。

显然，Microsoft Visual C++ Redistributable packages 不仅仅包含这些，最关键的是，如果手动找全了所有的 dll，是否会出现其他的无法运行问题。

  • 下载 Visual C++ Redistributable Package，将 Visual C++ Redistributable Package 安装程序包含在安装包中，并在安装过程中自动安装。这样可以确保目标机器上安装了所有必要的运行时库，一同放入安装包内。

    1. 前往 Microsoft Visual C++ Redistributable Packages 页面。
    2. 下载适用于 Cocos2d-x 应用程序的所有必要的 Visual C++ Redistributable Packages。例如，Visual Studio 2013、2015 - 2022，下载相应的 redistributable 安装程序，还有 Windows SDK。
    3. 设置 Inno 安装脚本时同时运行这个安装包。
    bash 复制代码 
    #define VcRedist "vcredist_x64.exe"
[Run]
; 安装 Visual C++ Redistributable
Filename: "{tmp}\{#VcRedist}"; Parameters: "/quiet /norestart"; StatusMsg: "Installing Visual C++ Redistributable..."; Flags: waituntilterminated

  • 在 Visual Studio 中配置静态链接运行时库，编译后重新打包（会增加可执行文件大小，Maybe 从 30M => 300M）。

    1. 打开项目属性。
    2. 导航到 C/C++ -> 代码生成。
    3. 在 运行时库 下，选择 多线程 (/MT) 或 多线程调试 (/MTd)。
    4. 重新编译项目。

5. 总结

本篇博客希望你不仅掌握了如何在 Visual Studio 项目中设置 .exe 文件的图标，还学会了使用 Inno Setup 创建包含自定义图标和安装路径的安装包。

我们还探讨了如何解决在目标机器上运行游戏时可能遇到的 DLL 缺失问题。希望这篇教程能帮助你更顺利地发布和分享你的游戏。

相关推荐
科技资讯早知道6 小时前
java计算机毕设课设—坦克大战游戏
java·开发语言·游戏·毕业设计·课程设计·毕设
程序猿阿伟1 天前
《C++游戏人工智能开发：开启智能游戏新纪元》
c++·人工智能·游戏
Artistation Game1 天前
九、怪物行为逻辑
游戏·unity·游戏引擎
妙为1 天前
unreal engine5制作动作类游戏时，我们使用刀剑等武器攻击怪物或敌方单位时，发现攻击特效、伤害等没有触发
游戏·游戏引擎·虚幻·碰撞预设
网站领航1 天前
服装时尚与动漫游戏的跨界联动：创新运营与策划策略研究
游戏·流量运营·用户运营
龙智DevSecOps解决方案1 天前
Perforce演讲回顾（上）：从UE项目Project Titan，看Helix Core在大型游戏开发中的版本控制与集成使用策略
游戏·ue5·源代码管理·perforce·helix core
dangoxiba1 天前
[Unity Demo]从零开始制作空洞骑士Hollow Knight第十三集：制作小骑士的接触地刺复活机制以及完善地图的可交互对象
游戏·unity·visualstudio·c#·游戏引擎
新手unity自用笔记1 天前
项目-坦克大战学习-游戏结束
学习·游戏
DK七七2 天前
【PHP陪玩系统源码】游戏陪玩系统app，陪玩小程序优势
前端·vue.js·游戏·小程序·php·uniapp
幻狐boke2 天前
【mod分享】山脊赛车无限高清重置mod，替换高清贴图和光影材质，可实现reshade光追
游戏·贴图
热门推荐
01【经验分享】Ubuntu22.04安装微信(linux官方版)02安卓系列机型永久去除data分区加密 详细步骤解析032024年高教社杯数学建模国赛C题超详细解题思路分析04CTF网络安全大赛简单的web抓包题目：HEADache05组基轨迹建模 GBTM的介绍与实现（Stata 或 R）06【2024数模国赛赛题思路公开】国赛B题思路丨附可运行代码丨无偿自提07pve(Proxmox VE)安装i225v网卡驱动08苍穹外卖面试总结09【2024高教社杯全国大学生数学建模竞赛】B题 生产过程中的决策问题——解题思路 代码 论文10RAG 实践- Ollama+RagFlow 部署本地知识库