第一章 安装

在本章中，我将简要概述不同的安装 X# 的选项。如果你想立刻开始编程，请跳过本章。安装 X# 的最简单方法是单击安装程序，几分钟后就可以启动 Visual Studio，选择模板，然后开始编码。

安装 X#

X#的当前 2.x 版本必须从 X# 官方网站下载和安装。此安装版本仅适用于Windows。下载内容为一个 zip 文件，它包含一个 Windows 安装程序文件。

X#网站的地址是 https://www.xsharp.eu

第一步是先登录或注册。如果不事先登录则无法下载。

下一步是访问“DownLoads”（下载）部分。

在下载之前，你需要认识到一点。X# 是免费和开源的，但也有一个供订阅者使用的私有版本（“XSharp 之友”，简称FoX），它不是免费的，而且需要您支付一笔钱。开发团队之所以这样做，是因为任何专业使用X# 的人都应该每年支付订阅费来支持开发团队，并在需要时获得更好的支持。

如果你是一个以使用 X# 编程为生的专业开发人员，请考虑购买许可证（这就像给您最喜欢的慈善组织一些捐赠，我们都知道，支持一个好的事业会让我们更快乐;)

包含 XSharp Runtime、Project System 和 Tool 源代码的公共存储库的项目的地址是 https://github.com/X-Sharp。

X#编译器的源代码地址为 https://github.com/X-Sharp/XSharpDev。

重要提示：这两个地址只对那些喜欢阅读、分析甚至贡献X# 编译器代码，或者想直接向开发人员报告错误的开发人员有意义。对于一般问题、建议或任何其他类型的评论或讨论，X#论坛是一个更好的地方。论坛中每个帖子迟早都会得到X# 团队成员的回复。

本书将使用 X# 的公共版本，例如“XSharp Cahors 2.20 Public Installer”。

将压缩包解压到一个临时文件夹中。其中仅包含一个exe 文件，例如：XSharpSetupPublic2.20.0.3.exe。

如果你在安装 X# 前忘记安装Visual Studio，安装程序会询问是否要为你下载（我得承认我还没试过这个选项）。

图 1.1：如果未安装Visual Studio，X# 的友好人员会为您下载它

双击 exe 文件开始安装。

选择 "下一步 "跳过欢迎界面。

接受许可协议并选择 "下一步 "继续。

阅读信息框，选择下一步继续。

确认安装目录为 C:\Program Files (x86)\XSharp 或选择其他目录，然后选择下一步继续。

注意：安装程序的默认行为是卸载之前的版本（版本号并不重要）。本章最后将介绍如何避免这一"限制"。

图 1.2：确认或选择X# 应用程序目录路径

要么确认预选的 X# 组件，要么更改选择。通常情况下，没有必要更改选择，但基于以下理由您也许会选择这么做：

l是否安装XIDE

l是否安装Net Core 编译器（它不再是公共版本的一部分）

l是否安装Visual Studio 集成，因为您可能仅需要 X# 编译器

l是否需要安装示例

l是否注册PRG 扩展

l是否需要本地图片

lX# 程序集是否应成为全局程序集缓存(GAC) 的一部分

是否安装 X# 的XIDE 和 .Net Core 编译器是其中两个最重要的选项：

图 1.3：为X# 安装选择组件

选择 "下一步 "继续。

确认或更改程序菜单中的快捷方式名称。

选择下一步继续。

选择 "安装 "最终开始安装。

如果在安装过程中 Visual Studio 仍在运行，安装将停止，安装程序会要求允许自动结束并稍后重启Visual Studio。这在大多数情况下是唯一的选择，因为安装程序总是会先卸载之前安装的X#，如果您已经安装了 Visual Studio 集成（通常是这种情况），则 Visual Studio 集成也随之卸载，而这个过程只有在 Visual Studio 当前未运行的情况下才有可能完成。另一个不关闭Visual Studio 的选项在大多数情况下并不可行。

图 1.4：X#正在安装中

安装完成需要几分钟时间。建议完成后查看Whatsnew.pdf 文件，因为它列出了截至所安装的最新版本的所有新增功能。

建议在安装成功后检查程序目录。表 1.1 是其目录及其中内容的简要说明。

表 1.1：X#应用程序目录下的子目录

示例在哪里？请查看系统的文档文件夹。您也可以通过已创建的快捷方式来打开它。

一些故障排除技巧

我不知道这种情况是否只发生在我身上（当时 X# 论坛上没有其他错误报告），但我在安装 Visual Studio Extension for Cahors 2.13（例如）和 Visual Studio 2022 时遇到了一些麻烦。设置完成后没有出现任何错误，但X# 扩展却没有安装，因此我无法加载任何 Xsproj 项目文件--结果是出现了一条不友好的错误信息。长话短说，虽然我没能找到问题的根源，但最终还是通过直接安装X# 扩展并在解决方案资源管理器中重新加载 X# 项目激活了扩展。

图 1.5：您不希望经常看到此错误信息

您可以在 XSharp 安装目录中找到vsix 文件（例如：D:\Program Files\XSharp\Extension\XSharpProject2022.vsix ）。只需双击vsix 文件即可安装扩展。然后通过解决方案资源管理器中的上下文菜单重新加载X# 项目。

图 1.6：重新安装 XSharp 扩展后重新加载XSharp 项目

如果直接安装也不成功，请删除 Visual Studio 目录中现有的 X# 扩展（例如，C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\Extensions ），然后再试一次。

因此，本节的提示是，在扩展不能自动加载的罕见情况下，不要轻易放弃，而要多做一些尝试，它可能会让你找到工作的X# 扩展的 "应许之地"（译者注：这是圣经典故）。最有希望（至少对我来说）的选择是直接安装X# 扩展（但你确实不需要重新安装 Visual Studio；）。

但请注意，这只能是在你想立即解决问题的情况下的最后手段。更好的办法是在 X# 论坛上报告问题。

提示：有一个日志文件（ActivityLog.Setup.xml）包含了安装 Visual Studio 扩展时的所有操作。其路径取决于 Visual Studio 的版本号（例如%appdata%\Microsoft\VisualStudio\17.0_543ccb56）。虽然不太可能找到问题真正原因的任何提示，但总是值得仔细查看一下。

安装 .Net Framework SDK

某些 X# 项目需要 Ic.exe 或AxImp.exe 等工具来完成构建过程。这些工具是 .Net Framework SDK 的一部分，可以通过 Windows SDK 安装来解决（版本号并不重要），也可以单独下载特定的SDK。无论如何，.Net Framework SDK 都应该在安装 Visual Studio 时一并安装，但如果由于某些不明原因，这些工具不在它们应该在的位置上，可能需要花些力气才能重新安装（我曾经不得不完全卸载Windows SDK，并删除属于该 SDK 的每个文件夹，才能让安装程序重新安装）。.Net Framework SDK exe 文件的路径类似于C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools。

仅安装 X# 编译器

也可以在不集成 Visual Studio 的情况下安装 X#。不选择 GAC 选项意味着XSharp 程序集仅被复制到安装目录中。

安装多个版本的 X#

安装程序的默认行为是先卸载之前的版本。你可以通过在命令行调用安装程序并添加/nouninstall 开关来阻止这种行为。这将阻止卸载之前的版本。因此，如果你选择了不同的文件夹，就有可能在一台电脑上安装多个X# 版本。但在 Visual Studio 中始终只能安装一个版本。