コンテンツにスキップ

開発環境のセットアップ⚓︎

このページでは、このドキュメントのチュートリアルを実行するために必要な依存関係と、実行方法を説明します。

ほとんどのチュートリアルでは、NEM と Symbol の両方のネットワークをサポートする Symbol SDK を使用します。 NEM アプリケーションの構築に推奨されるライブラリなので、以下の手順はすべてのチュートリアルに適用できます。

使用する言語を選択してください。

前提条件Python 3.10 以降
インストール 次のコマンドで Symbol SDK バージョン 3.3.3 をインストールします。 
pip install symbol-sdk-python --upgrade
サンプルコードの実行 サンプルをダウンロードして、次のコマンドで実行します。 
python hello-world.py

トラブルシューティング

システムによっては、Python の依存関係の一部がソースからビルドされるため、SDK のインストールに追加のシステムパッケージが必要になる場合があります。

ヘッダー、ライブラリ、コンパイラツールが見つからないというエラーでインストールに失敗した場合は、使用しているシステムに必要な 開発用パッケージ をインストールして、もう一度インストールを実行してください。

よくある症状として、gcc または pysha3 に関するメッセージが表示されます。

Ubuntu と Debian では、通常、次のコマンドで十分です。

sudo apt install python3-dev build-essential

その後、Symbol SDK のインストールをもう一度実行してください。

前提条件Node.js の現在サポートされているバージョン
インストール プロジェクトフォルダーを作成し、依存関係として Symbol SDK バージョン 3.3.3 をインストールします。 
mkdir nem-dev && cd nem-dev
npm init -y
npm install symbol-sdk
サンプルコードの実行 サンプルをダウンロードして、次のコマンドで実行します。 
node hello-world.mjs

前提条件JBang

チュートリアルでは、Java のバージョン管理と依存関係の管理を簡単にするために JBang を使用します。 ただし、アプリケーションで必ず JBang を使う必要はありません。

インストール Java スニペットでは JBang コメントを使って、互換性のある Java バージョンを指定し、 Maven Central から Symbol SDK を直接読み込みます。 
//JAVA 21+
//DEPS org.symbol:symbol-sdk:3.3.3

スニペットを実行すると、JBang は Symbol SDK とその依存関係をローカルキャッシュにダウンロードします。 pom.xml、build.gradle、手動でのクラスパス設定は不要です。

サンプルコードの実行 サンプルをダウンロードして、次のコマンドで実行します。 
jbang HelloWorld.java

別の SDK インストール方法

スタンドアロンスニペットを実行するのではなく Java アプリケーションを構築する場合は、 使用しているビルドツールで Symbol SDK をプロジェクトに追加してください。

repositories {
    mavenCentral()
}

dependencies {
    implementation("org.symbol:symbol-sdk:3.3.3")
}

<dependency>
    <groupId>org.symbol</groupId>
    <artifactId>symbol-sdk</artifactId>
    <version>3.3.3</version>
</dependency>

Java 21 以降を使用してください。

トラブルシューティング

  • インストール後に jbang コマンドが見つからない場合は、ターミナルを再起動してからもう一度試してください。

  • Java スニペットは //JAVA 21+ を宣言しているため、利用可能であれば JBang は互換性のある JDK を使用します。

    JBang が JDK を見つけられない、またはダウンロードできない場合は、Java 21 以降の JDK をインストールしてからスニペットを再実行してください。

  • Symbol SDK の依存関係を解決できない場合は、ネットワーク接続を確認し、JBang のキャッシュをクリアしてから、 スニペットを再実行してください。

    jbang cache clear
jbang HelloWorld.java

次のステップ⚓︎