サポートされるプラットフォーム: Windows®、Linux®、Mac
この例では、ライブラリ コンパイラ アプリを使用して、MATLAB® 関数用を使用する Python® パッケージを作成する方法を示します。生成されたパッケージは、アプリケーションへの統合を担当する開発者に渡すことができます。また、この例では、Python アプリケーションから Python パッケージを呼び出す方法も示します。MATLAB のライセンス コピーがターゲット システムにインストールされている必要はありません。
MATLAB で、パッケージ化する MATLAB コードを調べます。この例では、次のように関数 makesqr.m
を記述します。
function y = makesqr(x)
y = magic(x);
MATLAB コマンド プロンプトで、makesqr(5)
と入力します。
出力は以下のようになります。
17 24 1 8 15 23 5 7 14 16 4 6 13 20 22 10 12 19 21 3 11 18 25 2 9
[MATLAB アプリ] タブで、[アプリ] セクションの右端にある矢印をクリックします。[アプリケーション配布] で、[ライブラリ コンパイラ] をクリックします。
または、MATLAB コマンド プロンプトで以下を入力して、[ライブラリ コンパイラ] アプリを開きます。
libraryCompiler
ツールストリップの [タイプ] セクションで、[Python パッケージ] をクリックします。
ライブラリ コンパイラ アプリのプロジェクト ウィンドウで、配布する MATLAB アプリケーションのファイルを指定します。
ツールストリップの [エクスポートする関数] セクションで、 をクリックします。
[ファイルの追加] ウィンドウで、サンプルのフォルダーを参照し、パッケージ化する関数を選択します。[開く] をクリックします。
エクスポートする関数ファイルのリストに関数が追加されます。同じアプリケーションに複数のファイルをパッケージ化するには、この手順を繰り返します。
この例では、先ほど記述した makesqr.m
ファイルを選択します。
ツールストリップの [パッケージ化オプション] セクションで次のオプションのいずれかを選択して、生成されるアプリケーションに MATLAB Runtime インストーラーを含めるかどうかを決定します。
ランタイムを Web からダウンロード — MATLAB Runtime をダウンロードして配布された MATLAB アプリケーションと共にインストールするインストーラーを生成します。インストーラーのファイル名を指定できます。
ランタイムをパッケージに含める — MATLAB Runtime インストーラーを含むアプリケーションを生成します。インストーラーのファイル名を指定できます。
メモ
このオプションを初めて選択したときに、MATLAB Runtime インストーラーをダウンロードするように求めるメッセージが表示されます。
[ライブラリ名] フィールドに、パッケージの名前として makesqr
が自動的に入力されます。この名前を MagicSquarePkg
に変更します。Python パッケージの命名要件の詳細については、Import Compiled Python Packagesを参照してください。
サンプル Python ドライバー ファイルを生成するための MATLAB ファイルを追加します。Python ドライバー ファイルはパッケージの作成に必須ではありませんが、MATLAB により生成された Python アプリケーションのインストールと実行の方法を示すために使用します。
[サンプル] セクションで、[新規サンプルの作成] を選択して makesqr.m
をクリックします。MATLAB ファイルが編集用に開きます。アプリケーションの必要に応じて入力変数を定義し、ファイルを保存して [ライブラリ コンパイラ] アプリに戻ります。詳細と制限については、サンプル ドライバー ファイルの作成を参照してください。
次のように、インストーラーのカスタマイズ、アプリケーションのカスタマイズ、アプリケーションに関する情報の追加を実行できます。
ライブラリ情報 — 配布されるアプリケーションに関する情報。また、アプリケーション アイコンとスプラッシュ スクリーンを変更して、アプリケーションの外観をカスタマイズすることもできます。生成されるインストーラーはこの情報を使用して、インストールされるアプリケーションのメタデータを入力します。インストーラーのカスタマイズを参照してください。
追加インストーラー オプション — 生成されるインストーラーの既定のインストール パスと、カスタム ロゴの選択。インストール パスの変更を参照してください。
ライブラリの実行に必要なファイル — 生成されるアプリケーションを実行するために必要な追加ファイル。これらのファイルは、生成されるアプリケーション インストーラーに含められます。コンパイラ プロジェクトの必須ファイルの管理を参照してください。
エンド ユーザー用にインストールされるファイル — アプリケーションと共にインストールされるファイル。これらのファイルには、以下が含まれます。
生成された readme.txt
ターゲット プラットフォーム用に生成される実行可能ファイル
アプリケーションと共にインストールするファイルの指定を参照してください。
パッケージ化されたアプリケーションを生成するには、[パッケージ化] をクリックします。
[プロジェクトを保存] ダイアログ ボックスで、プロジェクトを保存する場所を指定します。
[パッケージ] ダイアログ ボックスで、[プロセスが完了したら出力フォルダーを開く] が選択されていることを確認します。
パッケージ化プロセスが完了したら、生成された出力を調べます。
ターゲット フォルダーの場所に for_redistribution
、for_redistribution_files_only
、for_testing
の 3 つのフォルダーが生成されます。
これらのフォルダーに生成されるファイルの詳細については、MATLAB 関数のパッケージ化後に生成されるファイルを参照してください。
PackagingLog.txt
— MATLAB Compiler™ により生成されたログ ファイル。
Python パッケージの作成後、Python アプリケーションからこれを呼び出すことができます。作成する Python アプリケーションでは、パッケージ化の際に生成されたサンプル Python ドライバー コードを使用します。この Python ドライバー コードは Python パッケージを呼び出し、以前のセットアップ手順で選択したサンプル MATLAB ファイルを基にしています。
これらの手順は、for_redistribution_files_only
フォルダーの GettingStarted.html
ファイルでも説明しています。開始する前に、MATLAB Runtime のインストールと構成が完了していて、Python がインストールされていることを確認してください。
生成された Python ドライバー コード ファイルを for_redistribution_files_only\samples
フォルダーからコピーして、共有ライブラリの作成時に作成された for_redistribution_files_only
フォルダーに貼り付けます。
システムのコマンド ラインを使用して、生成されたサンプル Python ドライバー コード ファイルをコピーした for_redistribution_files_only
フォルダーに移動します。
システムのコマンド プロンプトで python
を使用して、アプリケーションをインストールします。
python setup.py install
システムのコマンド プロンプトからアプリケーションを実行します。
python makesqrSample1.py
メモ
macOS では、mwpython
スクリプトを使用しなければなりません。mwpython
スクリプトは
フォルダーにあります。matlabroot
/binmatlabroot
は MATLAB がインストールされている場所です。
たとえば、mwpython makesqrSample1.py
などです。
deploytool
| libraryCompiler
| mcc
| mwpython