# TWELITE SDK のインストール

{% hint style="success" %}
MWSDK 2020-04 以降は TWELITE STAGE アーカイブに含まれます。

TWELITE STAGEアプリからビルドする場合は、`MWSDK_ROOT` 環境変数の設定が不要になります。

MWSDK 2019-12 と同じの方法でビルドする場合は、TWELITE STAGE アーカイブ中の MWSDK ディレクトリの構成は大きく変わっておりませんので、読み替えて利用ください。

TWELITE STAGE については以下をご覧ください。

* [インストール・使用方法](https://mono-wireless.com/jp/products/stage)
* [インストール補足情報](https://stage.twelite.info/)
  {% endhint %}

TWELITE SDK (MWSDK) をインストールします。本書ではMWSDKと記載します。

{% hint style="warning" %}
TWELITE SDKは**TWENET MWX C++ ライブラリ対応版**をダウンロードしてください。
{% endhint %}

### 1. MWSDK 圧縮アーカイブファイルのダウンロード

MWX 対応 SDK の圧縮アーカイブファイルを[ダウンロード](https://mono-wireless.com/jp/products/TWE-NET/index.html#MWX)してください。

### 2. 圧縮アーカイブの展開

圧縮アーカイブファイルを展開してください。

{% hint style="danger" %}
展開先のディレクトリ名にはスペース、日本語名が含まれてはいけません。
{% endhint %}

### 3. 環境変数の設定

`MWSDK_ROOT`, `MWSDK_ROOT_WINNAME`(Windows10のみ) の設定が必要です。

{% tabs %}
{% tab title="Windows10" %}
ここでは展開後のディレクトリ名を `C:\MWSDK` とします。別のディレクトリにインストールした場合は、読み替えてください。

`C:\MWSDK\SET_ENV.CMD` を実行してください。以下の環境変数を設定します。

* `MWSDK_ROOT`
* `MWSDK_ROOT_WINNAME`

例えば以下のような設定になります。

```
MWSDK_ROOT=C:/MWSDK/
MW_ROOT_WINNAME=C:\MWSDK\
```

{% hint style="warning" %}
インストールしたPC上からMWSDKをアンインストールするには以下を行ってください。

* `UNSET_ENV.cmd`を実行してください。環境変数の設定を解除します。
* MWSDKディレクトリを削除してください。
  {% endhint %}
  {% endtab %}

{% tab title="Linux" %}
開発環境やシェルに `MWX_ROOT`環境変数を反映されるように設定してください。

方法はいくつかありますが、ホームディレクトリの`.profile`（ファイルがなければ新しく作成してください）に以下の設定を追加します。この設定でVSCodeのビルドまで可能です。

`MWSDK_ROOT=/foo/bar/MWSDK/`\
`export MWSDK_ROOT`

エディタを使用せずに追加するには以下のようにコマンド入力します。`$`はプロンプトで環境によって表示が違います。`/foo/bar/MSWSDK`の部分はインストールしたディレクトリに応じて書き換えてください。

```bash
$ cd $HOME
$ echo MWSDK_ROOT=/foo/bar/MWSDK>>.profile
$ echo export MWSDK_ROOT>>.profile
```

{% endtab %}

{% tab title="macOS" %}
開発環境やシェルに `MWX_ROOT`環境変数を反映されるように設定してください。

方法はいくつかありますが、ホームディレクトリの`.profile`（ファイルがなければ新しく作成してください）に以下の設定を追加します。この設定でVSCodeのビルドまで可能です。

`MWSDK_ROOT=/foo/bar/MWSDK/`\
`export MWSDK_ROOT`

エディタを使用せずに追加するには以下のようにコマンド入力します。`$`はプロンプトで環境によって表示が違います。`/foo/bar/MSWSDK`の部分はインストールしたディレクトリに応じて書き換えてください。

```bash
$ cd $HOME
$ echo MWSDK_ROOT=/foo/bar/MWSDK>>.profile
$ echo export MWSDK_ROOT>>.profile
```

{% hint style="info" %}
環境全体に`MWSDK_ROOT`を適用にするにはLaunchDを用います。

VS Codeの一部の設定で環境変数を参照していますが、ビルドには必須ではありません。
{% endhint %}
{% endtab %}
{% endtabs %}

### 4. ライブラリの修正の適用

SDKに収録された時点から、ライブラリソースコードに修正がある場合があります。[改版履歴](/v0.1.5/revisions.md)を参照の上、必要に応じでライブラリソースコードを差し替えてください。

<br>


---

# 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://mwx.twelite.info/v0.1.5/install_n_build/install_sdk.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.