# 1.1: 安装

以下是安装Karamba 3D的前提条件：

* Rhino 5.0, Rhino 6.0或Rhino 7.0
* Grasshopper (Karamba3D的1.3.3版本已在GH 1.0.0007上进行了测试)

如果您还未曾安装Rhino软件，可从以下网址下载功能齐全的免费试用版本：<http://www.rhino3d.com/download.html>. Rhino5 的 Grasshopper 插件是免费的，可通过以下链接找到：<http://www.grasshopper3d.com/>. 它已被整合在 Rhino6 以及 Rhino7中。

## 标准安装

请在[下载](https://www.karamba3d.com/download/)安装程序后双击msi-文件。使用Rhino5时，请确保选择正确的安装位数（32或64）。Rhino5的64位版本名为“Rhinoceros 5 (64-bit）”。Rhino6和Rhino7仅提供64位应用程序。

在安装过程中，用户可以设置用于运算的物理单位。默认情况下，Karamba3D假定其输入为国际单位制（例如，使用米为点坐标单位）。用户可在安装时或在安装后通过编辑[“karamba.ini”](https://manual-1-3.karamba3d.com/chinese_1_3_3/troubleshooting/4.3.-miscellaneous-problems/4.1.6-changing-karamba.ini-file)文件将运算的物理单位切换到英制单位。这种情况下坐标的单位将为“feet（英尺）”，力的单位为“kips（千磅）”，而材料强度则为“ksi（千磅/平方英寸）”，等等。

{% hint style="info" %}
如果用户打算在后期激活PRO（专业版）或EDU（教育版）使用授权许可，请确保安装完整版Karamba3D。
{% endhint %}

![](https://2244769574-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M9XteyGDAU3Odla53cC%2Fsync%2F981b57e9c90e79e62b8a3cfa616cea8c7d10999d.jpg?generation=1591871188570355\&alt=media)

安装成功后，在Rhino中打开Grasshopper时会看到一个Karamba3D标签。此外，作为默认设置，安装文件夹的快捷方式将会出现在计算机桌面上。

如未能显示Karamba3D图标，请参考我们的[故障排除指南](https://manual-1-3.karamba3d.com/chinese_1_3_3/troubleshooting/4.3.-miscellaneous-problems/4.3.1-installation-issues)。

Karamba3D的安装可以为独立、云端或网络使用授权许可：

{% content-ref url="1.2-licenses/1.1.1-standalone-licenses" %}
[1.1.1-standalone-licenses](https://manual-1-3.karamba3d.com/chinese_1_3_3/1-introduction/1.2-licenses/1.1.1-standalone-licenses)
{% endcontent-ref %}

{% content-ref url="1.2-licenses/1.2.4-cloud-licenses" %}
[1.2.4-cloud-licenses](https://manual-1-3.karamba3d.com/chinese_1_3_3/1-introduction/1.2-licenses/1.2.4-cloud-licenses)
{% endcontent-ref %}

## 虚拟机软件parallel上的Rhino5, Rhino6和Rhino7

用户可将Rhino 5的64位版本与Rhino 6和Rhino 7版本的Karamba3D一起安装。只需依次先后运行两个安装程序即可。&#x20;

不过，Rhino 5的32位版本Karamba3D无法与其他任何版本一同安装。

## 静默安装

出于在远程计算机上安装Karamba3D的目的，“msiexec.exe”提供了一些选项来规避安装程序的图形用户界面。启动Windows CommandPrompt，导航到Karamba 3D安装程序所在的位置后键入如下内容：

msiexec.exe /i karamba3d\_1\_3\_2\_RH7.msi /passive ADDLOCAL=FullFeatures,SIUnits,LicensePublicKey,Tables,Examples

用户只需键入如上文的一行文字即可安装包括SI-Unit（国际单位制），横截面和材料表格（“Tables（表格）”）以及定义范例（“Examples（示例）”）等在内的完整版本Karamba 3D（“FullFeatures（完整功能 ）”）。出于获取免费版本的考虑，在英制单位中将“FullFeatures（完整功能）”替换为“FreeFeatures（自由功能）”，将“SIUnits（国际单位制）”替换为“IM-PUnits（英制单位制）”。

通过将使用授权许可文件重新命名为“licensePRO.lic”并将其复制到...\Rhino Plug-ins\Karamba\下面的“License”文件夹内，可以在不使用图形用户界面（GUI）的情况下提供静默使用授权信息。

## 自动安装

在安装过程中，以下文件和文件夹将被复制到您的机器上：

* 将“karamba.dll” 和 “libiomp5md.dll” 添加至 C:\Windows.
* 将“karambaCommon.dll”、“karamba.gha”和Karamba文件夹添加到Rhino的“Plug-ins”文件夹中。Karamba3D文件夹包含材料库和横截面库、范例、karamba.ini文件，以及使用授权许可文件夹。通常位于C:\Program Files\Rhinoceros 5 (64-bit)\Plug-ins或C:\Program Files\Rhino 6\Plug-ins。
* 如果Visual Studio 2019的C++运行时库尚不存在，请将其复制到您的计算机上。

默认情况下，将为计算机上所有用户安装Karamba3D。如希望在没有安装程序的情况下运行Karamba3D，只需将上述文件和Karamba3D文件夹从一台计算机复制到另一台。除非取消选择，否则安装程序会在计算机桌面上放置一个Karamba3D图标。双击该图标可以打开Karamba3D文件夹。

## 在Mac上安装

现阶段，Karamba3D仅适用于Windows用户。在安装Parallels或Bootcamp Windows的前提下，Mac用户也可以运行Karamba3D。