【笔记】reko 0.10.2 反编译工具安装和使用记录｜(1) README.md

(翻译自README.md，并通过自己的实际操作情况重新整理了一遍)

笔者注：我已经成功地根据README.md下载了Release版本，也自己试了下从源码编译，跟着README都挺顺利的。如果操作过程中遇到问题，请留言。

Reko 简介

Reko (瑞典语: “适当的, 乐于助人的”) 是一个二进制文件的反编译器。

该项目可在GNU通用公共许可证下免费获得.

该项目具有图形界面，也可以直接通过命令行使用。前端使用ASP.NET。
Reko项目文件包含有关二进制文件的其他信息，这些信息有助于反编译过程或者格式化输出。

ARM 二进制可执行文件的 Map view

ARM 二进制可执行文件的 Decompiled view

Reko追求的目标是在最小的用户干预下、对于各种各样的处理器结构和可执行文件格式都支持反编译。完整的支持列表请见网址 Reko 支持的处理器和可执行文件格式 。

请注意，很多的软件证书禁止对它们的机器码二进制文件进行反编译器或者其他逆向工程。你只有拥有了合法的反编译权限才能使用这个反编译器(例如如果这个二进制文件是你自己的)。

1. 下载 Reko

官方的 Releases 每隔几个月就会在 Github 和 SourceForge上发布。

不想或无法自己生成Reko的用户，可以从Cirrus CI integration builder 或者 Github Actions integration builder下载二进制文件。

笔者下载的链接：windows_x64 0.10.2。

当然，你想自己构建生成也是可以的，详见下文的Hacking部分。

2. 安装 Reko

安装Reko之前，必须先装NET 5.0：

• .NET 5.0 (https://www.microsoft.com/net/download/dotnet-framework-runtime)

如果需要开发Reko，并使用VS2019，则必须安装VS的C#组件。

3. 相关文档

想了解Reko的各种特性，你可以读 user’s guide.md | github。如果你对项目的内部工作原理感兴趣，请看 reko wiki。

笔者注：国内镜像 user’s guide_(hub.fastgit.org)，wiki (hub.fastgit.org)。
为方便打开，之后的github内的链接一律直接使用镜像hub.fastgit.org，不做说明。

4. 获得帮助

你可以在 issue tracker | github 上报告你遇到的任何问题或者询问与Reko相关的任何问题。
你也可以试试 Reko 聊天室 Gitter.im。Reko 是靠志愿者在闲暇时自发构建的，所以有时候不会回复得特别及时。

笔者注：志愿者们回复得超级快。点赞！

5. 自己编译生成 Reko

想要构建生成reko，首先要clone源代码：git clone https://hub.fastgit.org/uxmal/reko.git。你可以用一个IDE或者命令行去构建解决方案文件Reko-decompiler.sln。Reko的构建生成需要.NET 5.0和C# 9。如果你是一个IDE使用者，请用Visual Studio 2019的最新版。

①如果你想用命令行构建它，用下列命令(如果你下载了 msbuild的话)：

msbuild -p:Configuration={config} -p:Platform={platform} -v:m -m Reko-decompiler.sln

注：将 {config} 替换为Debug 或者 Release, 将 {platform} 替换为 x64 或者 x86.
注：命令行编译方式容易出问题。不推荐。

笔者注：

1. 这里的命令行指的是VS中的工具-命令行。
2. 注意不要删掉克隆的文件夹下的.git文件夹，否则可能出现MSB3073错误(如下图)。
   

②如果你不打算用命令行编译：双击src文件夹下的Reko-decompiler.sln工程文件，打开后，编译选项选择Release和x64(或其他)，右键解决方案，选择重新生成解决方案，即可编译。

不能直接点击运行，否则会出现下图所示的错误：

Note: 如果你仍然不能编译，请告诉我们，我们会帮助你解决问题。如果你对贡献代码有兴趣，可以看看我们的开发路线图road map，看看可供探索的领域。我们的 Wiki 中有更多关于Reko内部工作原理的信息。请查阅 style guide。

5.1 与 WiX 相关的 Warnings 或 Errors

如果你没有在你的开发机器上下载WiX工具集的话，你在VS中加载解决方案的时候将会收到warnings 或者 errors。如下图所示。

这个WiX工具集仅仅在你制造MSI安装包的时候被用到，如果你已经能够编译这个项目，你可以忽略这些错误——因为构建生成的过程会将所有必需的文件都复制到一个独立的目录下。

如果你真的想要用WiX工具链构建生成一个MSI安装器，你可以在这下载WiX工具：http://wixtoolset.org/releases/。

5.2 与 VS 中的 CMake 相关的 Errors（这一节直接跳过吧我也没太明白说的啥）

你做了些什么之后，VS可能会重新构建生成依赖CMake的NativeProxy。你可以下载 CMake 并确保它被添加到你的环境变量PATH中，或者在VS中禁用这个工作(指重新生成NativeProxy)。

在VS中下好CMake已经足够去在Developer Command Prompt(笔者注：这是VS中的命令行工具)中运行msbuild了，但是可能还是无法在VS中成功地构建生成，除非你把CMake添加到你的环境变量PATH中。在VS外面下载CMake，可以让你在安装的时候将它添加到环境变量中。

5.3 编译后怎么打开 Reko ?

编译之后，src下的 Drivers文件夹包含了以用户界面为启动方式的可执行文件； WindowsDecompiler 文件夹包含了为 Windows用户提供的GUI客户端；CmdLine 文件夹下包含了一个命令行驱动程序。
点击Drivers文件夹，进入如下图的目录即可。

6. 版本说明

请在NEWS.md查看。

---

笔者注：下一篇看user’s guide。