> For the complete documentation index, see [llms.txt](https://manual.karamba3d.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.karamba3d.com/jp/1-hajimeni/a.2-installation.md).

# 1.1 インストール

Karamba3Dをインストールするための前提条件は以下のとおりです:

* Rhino 6.0（PCのみ）、Rhino 7.0、またはRhino 8.0。
* Grasshopper
* Windows 10 以上 / macOS 12 以上

[Rhino](https://www.rhino3d.com/) をお持ちでない場合は、フル機能の無料体験版をダウンロードしてください。

## インストーラープログラム経由のインストール

{% embed url="<https://youtu.be/eWdkANwKIHU>" %}

インストーラーの1つを[ダウンロード](https://github.com/karamba3d/K3D_NightlyBuilds/releases)し、msiファイルをダブルクリックしてください。

インストール手順では、計算で使用する物理単位 (physical units) を設定できます。デフォルトではKaramba3Dは入力をSI単位（例: 点座標はメートル）として想定します。インストール時、またはその後にGrasshopper / Karamba3Dメニューの「Physical Units」からヤード・ポンド法に切り替えることもできます。ヤード・ポンド法を使用すると、座標は「フィート」、力は「キップ」、材料強度は「ksi」などとして解釈されます。

[Rhino8](https://www.rhino3d.com/en/docs/guides/netcore/) には2つのインストーラーファイルが存在します: 1つは .NETFramework 用、もう1つは .NETCore 用です。デフォルトでは Rhino 8 は .NETCore 上で動作します。古いプラグイン (plug-in) を実行するために、Rhino 8 はコマンド「SetDotNetRuntime」で .NETFramework モードに切り替えることができます。このような場合には、Karamba3D の .NETFramework 版を使用できます。

インストールが成功すると、Rhino で Grasshopper を開いたときに Karamba3D タブ (tab) が表示されるはずです。さらに、デフォルト設定として、インストールフォルダーへのショートカットがデスクトップに配置されます。Karamba3Dのデスクトップアイコンをダブルクリックすると、標準のインストールディレクトリに移動します。これは、Rhinoのインストールディレクトリの Plug-ins フォルダー内にあります。

Karamba3Dが表示されない場合は、[トラブルシューティング](/jp/toraburushtingu/4.3.-miscellaneous-problems/4.3.1-installation-issues.md)ガイドを参照してください。

Karamba3Dのライセンスは、クラウドライセンスまたはネットワークライセンスとしてアクティベートできます。スタンドアロンライセンスはワークショップや大学でのみ有効です。

{% content-ref url="/pages/GjkgY3qiSXKBMeijV15g" %}
[1.2.1 クラウドライセンス](/jp/1-hajimeni/1.2-licenses/1.2.1-cloud-licenses.md)
{% endcontent-ref %}

{% content-ref url="/pages/FXYoaGTo6kPwWeV4jVgF" %}
[1.2.4 スタンドアロンライセンス](/jp/1-hajimeni/1.2-licenses/1.2.4-standalone-licenses.md)
{% endcontent-ref %}

{% content-ref url="/pages/yTGgQFV2eCsZSsQIx3RF" %}
[1.2.2 ネットワークライセンス](/jp/1-hajimeni/1.2-licenses/1.2.2-network-licenses.md)
{% endcontent-ref %}

## YAKパッケージマネージャー (package manager) 経由のインストール

{% hint style="danger" %}
Karamba3Dはmsiファイル**または**YAKのいずれかでのみインストールできます。両方を同時にインストールすると、「Karamba3DGetLicense」コマンドが動作しません。\
両方をインストールしてしまった場合: 両方をアンインストールし、Rhinoのオプション/プラグインからKaramba3DLicenseプラグインを削除してください。「Enabled」のチェックを外し、Rhinoを再起動します。
{% endhint %}

{% embed url="<https://www.youtube.com/watch?feature=youtu.be&v=-lj_u15k420>" %}

YAK は Rhino のパッケージマネージャーです。特定の Grasshopper 定義に必要なプラグインを自動的にダウンロードしてインストールできます。したがって、Karamba3D をインストールする方法の1つとして、Karamba3D コンポーネントが含まれる GH 定義を開く方法があります。あるいは、Rhino のコマンドウィンドウに「PackageManager」と入力してパッケージマネージャーを起動することもできます。

[「Package Manager」を開くには、こちらをクリックしてください。](rhino://package/search?name=karamba3D)

Karamba3Dのベータ版をインストールする場合は、表示されるウィンドウで「Include pre-releases」を必ず有効にしてください。YAK では Karamba3D は「karambaGH」として提供されており、Karamba3D の FULL 版がインストールされます。

Rhino8 のパッケージマネージャーは Windows 上で Karamba3D の .NETCore 版を %appdata%\McNeel\Rhinoceros\packages\8.0 フォルダーにインストールします。これは msi インストーラーで配置される場所とは異なります。

YAKによるKaramba3Dのインストール後、初めてGrasshopperを起動すると、著作権表示および利用規約を含むウィンドウが表示されます。

著作権表示およびライセンス契約は、Windowsでは C:\ProgramData\Karamba3D\ に保存されています。

{% hint style="info" %}
Karamba3D へのパス (path) は、msi インストーラーまたは YAK のどちらでインストールしたかによって異なります。これは Karamba3D API を利用するスクリプトが壊れる可能性があることを意味します。GH C# スクリプトコンポーネントの場合は、コンポーネントのコンテキストメニュー (context menu) から「Manage Assemblies...」でパスを調整する必要があります。
{% endhint %}

{% hint style="warning" %}
Karamba3DをRhino8 for Macで実行するには、[Rosetta](/jp/toraburushtingu/4.3.-miscellaneous-problems/4.3.1-installation-issues.md#karamba3d-for-rhino8-mac-does-not-seem-to-show-up)を必ず有効にしてください。
{% endhint %}

## Rhino6、Rhino7、Rhino8の並行インストール

Karamba3DのRhino 6、7、8の各バージョンを同時にインストールできます。1つを msi インストーラーで、もう1つをパッケージマネージャーでインストールします。

## サイレントインストール

リモートマシン上でインストーラーのグラフィカルユーザーインターフェイスを表示せずに Karamba3D をインストールするには、Windowsコマンドプロンプトから `msiexec.exe` ツールを使用できます。まず、Karamba3D インストーラーが含まれるディレクトリに移動してから、以下のようなコマンドを1行で実行します:

`msiexec.exe /i karamba3d_2_0_0_RH6.msi /passive ADDLOCAL=DLLs,LicensePlugin,SIUnits,LicensePublicKey,Tables,Examples`

これにより、SI 単位 (`SIUnits`)、断面および材料テーブル (`Tables`)、およびサンプルファイル (`Examples`) を含む Karamba3D がインストールされます。

**GUIなしでのライセンスセットアップ**

スタティックライセンスは、グラフィカルインターフェイスを使用せずに提供できます。ライセンスファイルの名前を `licensePRO.lic` に変更し、...\Rhino\Plug-ins\Karamba 配下の `License` フォルダーに配置するだけです。

**Windows で Karamba3D とともに msiexec を使用する:**

*msiexec* の基本構文は次のとおりです:

`msiexec /option <required parameter> [optional parameter]`

**msiexec のインストールオプション:**

パッケージをインストールするには、*/i* オプションとパッケージへのパスを使用します:

`msiexec /i "C:\path\to\karamba.msi"`

その他のインストールオプションには次のものがあります:

* */a*: 管理者インストール。
* */ju*: 現在のユーザーに対して製品を通知。
* */jm*: すべてのユーザーに対して製品を通知。
* */x*: パッケージをアンインストール。

`ADDLOCAL` によるインストールオプション

`ADDLOCAL` パラメータでコンポーネントを指定することで、インストールをカスタマイズできます:

* `DLLs`: FEMカーネルDLLをインストールします。
* `LicensePlugin`: ライセンスのアクティベーションに使用される Rhino プラグインを追加します。
* `SIUnit` または `IMPUnits`: デフォルトの単位系を設定します（後で Grasshopper の Karamba3D メニューから変更可能）。
* `LicensePublicKey`: ライセンスの検証に必要な公開鍵をインストールします。
* `Tables`: 断面および材料テーブルをインストールします。
* `Examples`: Grasshopper のサンプル定義をインストールします。

## **インストールの自動化**

インストール時に、次のファイルおよびフォルダーがマシンにコピーされます:

* "karamba.dll" および "libiomp5md.dll" は C:\Windows に。
* "karambaCommon.dll"、"karamba.gha"、および Karamba フォルダーは Rhino の「Plug-ins」フォルダーに。Karamba3D フォルダーには材料および断面ライブラリ、サンプル、karamba.ini ファイル、ライセンスフォルダーが含まれます。これは通常 *C:\Program Files\Rhinoceros 6\Plug-ins* または *C:\Program Files\Rhino 6\Plug-ins* です。
* まだインストールされていない場合は、Visual Studio 2019 の C++ ランタイムライブラリがマシンにコピーされます。

Karamba3D はデフォルトですべてのユーザー向けにインストールされます。インストーラーを使わずに Karamba3D を動作させるには、上記のファイルと Karamba3D フォルダーをあるマシンから別のマシンへコピーするだけです。\
選択を解除しない限り、インストーラーはデスクトップに Karamba3D アイコンを配置します。これをダブルクリックすると Karamba3D フォルダーが開きます。