# 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”](/chinese_1_3_3/troubleshooting/4.3.-miscellaneous-problems/4.1.6-changing-karamba.ini-file.md)文件将运算的物理单位切换到英制单位。这种情况下坐标的单位将为“feet（英尺）”，力的单位为“kips（千磅）”，而材料强度则为“ksi（千磅/平方英寸）”，等等。

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

![](/files/-M9XuT5CMtWbRtGV3DNq)

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

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

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

{% content-ref url="/pages/-M9XuRBE2vAYNRXSaGEr" %}
[1.2.1: 独立使用授权许可](/chinese_1_3_3/1-introduction/1.2-licenses/1.1.1-standalone-licenses.md)
{% endcontent-ref %}

{% content-ref url="/pages/-M9XuRBIBbBeipcBcenh" %}
[1.2.4: 云端使用授权许可](/chinese_1_3_3/1-introduction/1.2-licenses/1.2.4-cloud-licenses.md)
{% 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。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manual-1-3.karamba3d.com/chinese_1_3_3/1-introduction/a.2-installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.