実行環境の準備

Python3 のインストール

CRI Atom Craft ロボット は、Python3.7, Python 3.8, Python 3.9 に対応しています。
動作確認は CPython 3.7.8, CPython 3.8.6, CPython 3.9.5 で行っています。
Python3 は、Python 公式サイトから入手してインストールします。

ローカル実行のための環境設定

ローカル実行のための環境設定を行います。
リモート実行のみを行う場合、本設定は不要です。

プラグインの種類の設定

CRI Atom Craft の「スクリプト」メニューから「スクリプト設定」を選択し、「スクリプト設定」ダイアログを表示します。
「プラグイン」タブから、使用するプラグインの種類（Python のバージョン）を指定します。

criatom_tools_atomcraft_api_plugin_type.png

作業PCにインストールした Python のバージョンに合ったプラグインを選択してください。
インストールされている Python のバージョンは、以下の方法で確認できます。

Windowsの場合
コマンドプロンプトから下記コマンドを実行します。

python --version

Macの場合
ターミナルから下記コマンドを実行します。

python3 --version

ロボットがPythonのインストール場所を認識するための設定

Windows の設定

Windowsでは、環境変数 PATH に Python のインストールパスを追加する必要があります。

例:

C:\Users\(user name)\AppData\Local\Programs\Python\Python37\
C:\Users\(user name)\Anaconda3\

PATH の設定が正しく行われているか確認するには、コマンドプロンプトを開き、以下のコマンドを実行します。

where python

pyenvやAnaconda で Python をインストールした場合

環境変数 PYTHONHOME に Python のインストールパスを追加します。

覚え書き
  • 公式サイトのインストーラーを使用してPythonをインストールする際に、 Add python.exe to PATH オプションにチェックを入れると、PATH 設定が自動で行わます。
  • 環境変数の設定が反映されない場合は、ユーザーサインアウト後に再度試みてください。

Mac の設定

Homebrew などを使用して Python3 をインストールした場合、設定の「Mac Python ライブラリ」からCRI Atom Craft のプラグインに記録されている、ローカル実行時に使用する Python3 ライブラリへのパス情報をターミナル経由で変更する必要があります。
下記の操作でコマンドを作成し、ターミナルで実行します。

(1)「スクリプト」メニューの「スクリプト設定」から「Mac Python ライブラリ」を選択

criatom_tools_atomcraft_api_macpython.png

「CRI Atom Craft で使用中の Python ライブラリ」は自動で入力されます。

(2)「これから CRI Atom Craft で使用する Python ライブラリ」に、使用するライブラリを入力

Homebrew で Python3 を入手した場合の例（Ver.3.7.8 を使用する場合の例）
/usr/local/Cellar/python/3.7.8/Frameworks/Python.framework/Versions/3.7/Python
Anaconda を使用する場合の例
/Users/(user name)/anaconda3/lib/libpython3.7m.dylib

※ (user name) と記載されている箇所は、環境によって異なります。

「これから CRI Atom Craft で使用する Python ライブラリ」を入力すると、「ターミナルで実行」ボタンがアクティブになります。

(3)「ターミナルで実行」ボタンを押して、CRI Atom Craft のプラグイン情報を更新

ダイアログに表示しているコマンドがターミナルにて実行され、CRI Atom Craft のプラグインの情報が更新されます。

覚え書き
  • 公式サイトのインストーラーで Python3 をインストールした場合、「Mac Python ライブラリ」の設定は必要ありません。
  • ターミナルから直接変更する場合
    下記コマンドを実行します。
    • Homebrew で Python3 を入手した場合のコマンド例（Ver.3.7.8 を使用する場合の例）
      sudo install_name_tool -change "/Library/Frameworks/Python.framework/Versions/3.7/Python" "/usr/local/Cellar/python/3.7.8/Frameworks/Python.framework/Versions/3.7/Python" "/Applications/CRIWARE/CRI ADX2/Tools Ver.3.44/CriAtomCraft.app/Contents/PlugIns/libCriAcApiPython37.dylib"
    • Anacondaを使用する場合のコマンド例
      sudo install_name_tool -change "/Library/Frameworks/Python.framework/Versions/3.7/Python" "/Users/(user name)/anaconda3/lib/libpython3.7m.dylib" "/Applications/CRIWARE/CRI ADX2/Tools Ver.3.44/CriAtomCraft.app/Contents/PlugIns/libCriAcApiPython37.dylib"
      ※ (user name) と記載されている箇所は、ユーザー名によって異なります。
注意
macOS Big Sur以降では、「Mac Python ライブラリ」の設定ができない不具合が確認されています。
詳細については、既知の不具合 の動作関連項目をご参照ください。

ユーザースクリプト検索パスの追加

スクリプトを新規に作成する前に、スクリプトファイルの検索先フォルダーを設定します。
「スクリプト設定」ダイアログの「ユーザースクリプト」タブにて、「追加」ボタンからフォルダーを指定します。
ここで設定したフォルダー内にあるスクリプトファイルは、スクリプトリストやスクリプトメニューに表示され、CRI Atom Craft から実行できるようになります。

criatom_tools_atomcraft_api_prepare_userscript_path.png


リモート実行のための環境設定

リモート実行のための環境設定を行います。
ローカル実行のみを行う場合、本設定は不要です。

リモート実行用プラグインパッケージの確認

リモート実行用プラグインパッケージは、CRI Atom Craft に同梱されています。

CriAtomCraft.exe ( Mac の場合、CriAtomCraft.app ) と同じ階層に robot フォルダーがあります。
この中の remote/Python フォルダーの中にある cri フォルダーが Python 版リモート実行用プラグインパッケージのルートフォルダーになります。
次の構造になっているか確認してください。

CriAtomCraft.exe (CriAtomCraft.app)
robotフォルダー
- remoteフォルダー
- Pythonフォルダー : Python版リモート実行用プラグインパッケージのルートフォルダー
- criフォルダー
- atomcraftフォルダー
- build.py : プラグインのスクリプトコード
- common.py : （同上）
- debug.py : （同上）
- project.py : （同上）
- preview.py : （同上）
- error.py : （同上）

Python版リモート実行用プラグインパッケージのルートフォルダーを環境変数 PYTHONPATH に追加する

コンソールからPython版リモート実行用プラグインパッケージのルートフォルダーを参照できるように、環境変数に PYTHONPATH を追加します。

Windowsの場合

Cドライブ直下に CRI Atom Craft ( CRI ADX SDK )を配置した場合、CriAtomCraft.exe は以下の場所に配置されています。

C:\cri\tools\ADX2\ver.3\CriAtomCraft.exe

この場合は、下記フォルダーを環境変数 PYTHONPATH に追加します。

C:\cri\tools\ADX2\ver.3\robot\remote\Python

Macの場合

Ver.3.44系の場合は、CriAtomCraft.app は以下の場所に配置されています。

/Applications/CRIWARE/CRI ADX2/Tools Ver.3.44/CriAtomCraft.app

この場合は、下記フォルダーを環境変数 PYTHONPATH に追加します。

/Applications/CRIWARE/CRI ADX2/Tools Ver.3.44/robot/remote/Python