主要内容

このページの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

Pythonパッケージの生成とPythonアプリケーションのビルド

サポートされるプラットフォーム:窗户®, Linux®、Mac

この例では,MATLAB®関数を使用するPython®パッケージの作成方法を説明します。生成されたパッケージは,Pythonアプリケーションに統合できます。また,この例では,PythonアプリケーションからPythonパッケージを呼び出す方法も示します。MATLABのライセンスコピーがターゲットシステムにインストールされている必要はありません。

MATLABでの関数の作成

MATLABで,パッケージ化するMATLABコードを調べます。この例では,次のように関数makesqr.mを記述します。

函数make qr(x) Y = magic(x);

MATLABコマンドプロンプトで,makesqr (5)と入力します。

出力は以下のようになります。

17 24 18 15 23 5 7 14 16 4 6 13 20 22 10 12 19 21 3 11 18 25 2 9

ライブラリコンパイラアプリを使用したPythonアプリケーションの作成

  1. (MATLABアプリ]タブで,[アプリ]セクションの右端にある矢印をクリックします。[アプリケーション配布)で,[ライブラリコンパイラ]をクリックします。

    または,MATLABコマンドプロンプトで以下を入力して,[ライブラリコンパイラ]アプリを開きます。

    libraryCompiler

  2. ツールストリップの[タイプ]セクションで,(Pythonパッケージ]をクリックします。

    ライブラリコンパイラアプリのプロジェクトウィンドウで,配布するMATLABアプリケーションのファイルを指定します。

    1. ツールストリップの[エクスポートする関数)セクションで,をクリックします。

    2. [ファイルの追加)ウィンドウで,サンプルのフォルダーを参照し,パッケージ化する関数を選択します。[開く]をクリックします。

    エクスポートする関数ファイルのリストに関数が追加されます。同じアプリケーションに複数のファイルをパッケージ化するには,この手順を繰り返します。

    この例では,先ほど記述したmakesqr.mファイルを選択します。

  3. ツールストリップの[パッケージ化オプション]セクションで次のオプションのいずれかを選択して,生成されるアプリケーションにMATLAB运行时インストーラーを含めるかどうかを決定します。

    • ランタイムをWebからダウンロード- - - - - -MATLAB运行时をダウンロードして配布されたMATLABアプリケーションと共にインストールするインストーラーを生成します。インストーラーのファイル名を指定できます。

    • ランタイムをパッケージに含める- - - - - -MATLAB运行时インストーラーを含むアプリケーションを生成します。インストーラーのファイル名を指定できます。

      メモ

      このオプションを初めて選択したときに,MATLAB运行时インストーラーをダウンロードするように求めるメッセージが表示されます。

パッケージ設定の指定

  1. [ライブラリ名)フィールドに,パッケージの名前としてmakesqrが自動的に入力されます。この名前をMagicSquarePkgに変更します。Pythonパッケージの命名要件の詳細については、导入编译的Python包を参照してください。

  2. サンプルPythonドライバーファイルを生成するためのMATLABファイルを追加します。Pythonドライバーファイルはパッケージの作成に必須ではありませんが,MATLABにより生成されたPythonアプリケーションのインストールと実行の方法を示すために使用します。

    [サンプル]セクションで,(新規サンプルの作成)を選択してmakesqr.mをクリックします。MATLABファイルが編集用に開きます。

    %演示函数y = makeqr (x)执行的示例脚本x = 0;%初始化xy = makesqr (x);
    x = 0をx = 3に変更し,ファイルを保存して,[ライブラリコンパイラ]アプリに戻ります。詳細と制限については,サンプルドライバーファイルの作成を参照してください。

アプリケーションとその外観のカスタマイズ

次のように,インストーラーのカスタマイズ,アプリケーションのカスタマイズ,アプリケーションに関する情報の追加を実行できます。

  • ライブラリ情報——配布されるアプリケーションに関する情報。また,アプリケーションアイコンとスプラッシュスクリーンを変更して,アプリケーションの外観をカスタマイズすることもできます。生成されるインストーラーはこの情報を使用して,インストールされるアプリケーションのメタデータを入力します。インストーラーのカスタマイズを参照してください。

  • 追加インストーラーオプション——生成されるインストーラーの既定のインストールパスと,カスタムロゴの選択。インストールパスの変更を参照してください。

  • ライブラリの実行に必要なファイル——生成されるアプリケーションを実行するために必要な追加ファイル。これらのファイルは,生成されるアプリケーションインストーラーに含められます。コンパイラプロジェクトの必須ファイルの管理を参照してください。

  • エンドユーザー用にインストールされるファイル——アプリケーションと共にインストールされるファイル。

    アプリケーションと共にインストールするファイルの指定を参照してください。

アプリケーションのパッケージ化

  1. パッケージ化されたアプリケーションを生成するには,[パッケージ化)をクリックします。

    [プロジェクトを保存]ダイアログボックスで,プロジェクトを保存する場所を指定します。

  2. [パッケージ]ダイアログボックスで,[プロセスが完了したら出力フォルダーを開く]が選択されていることを確認します。

    パッケージ化プロセスが完了したら,生成された出力を調べます。

    • ターゲットフォルダーの場所にfor_redistribution、for_redistribution_files_only、for_testingの3つのフォルダーが生成されます。

      これらのフォルダーに生成されるファイルの詳細については,MATLAB関数のパッケージ化後に生成されるファイルを参照してください。

    • PackagingLog.txt- - - - - -MATLAB编译器™により生成されたログファイル。

compiler.build.pythonPackageを使用したPythonパッケージの作成

メモ

ライブラリコンパイラアプリを使用してPythonパッケージが既に作成されている場合は,この節を省略できます。一方,プログラムによる方法でMATLABコマンドウィンドウからPythonパッケージを作成する方法を確認する場合は,以下の手順に従ってください。

  1. 以下のコードをmakesqrSample1.mという名前のサンプルファイルに保存します。

    x = 3;一个= makesqr (x);

  2. 関数compiler.build.pythonPackageと先ほど作成したmakesqr.mファイルを使用して,Pythonパッケージをビルドします。名前と値の引数を使用してサンプルファイルを追加し,パッケージ名を指定します。

    buildResults = compiler.build.pythonPackage (“makesqr.m”，.．.“PackageName”，“MagicSquarePkg”，.．.“SampleGenerationFiles”，“makesqrSample1.m”）;

    compiler.build.ResultsオブジェクトbuildResultsに,ビルドタイプ,生成されたファイル,ビルドオプションに関する情報が格納されます。

  3. この構文により,現在の作業ディレクトリのMagicSquarePkgpythonPackageという名前のフォルダー内に以下のファイルが生成されます。

    • 样品\ makesqrSample1.py——Pythonサンプルドライバーファイル。

    • GettingStarted.html——パッケージの統合に関する情報が含まれるHTMLファイル。

    • mccExcludedFiles.log——アプリケーションに含まれていないすべてのツールボックス関数のリストが含まれるログファイル。サポートされていない関数の詳細については,MATLAB编译器の制限を参照してください。

    • 固定——パッケージ化およびインターフェイスの情報が含まれるテキストファイル。

    • requiredMCR下载188bet金宝搏Products.txt- - - - - -MATLAB运行时がアプリケーションを実行するために必要な製品の製品IDが含まれるテキストファイル。

    • setup . py——パッケージをインストールするPythonファイル。

    • unresolvedSymbols.txt——未解決のシンボルに関する情報が含まれるテキストファイル。

    メモ

    生成されたパッケージにMATLAB运行时やインストーラーは含まれていません。

  4. compiler.buildコマンドでは,以下の名前と値の引数を1つ以上使用することによって,追加オプションを指定できます。

    • “AdditionalFiles”——パッケージに含める追加ファイルへのパス。

    • “AutoDetectDataFiles”——データファイルを自動的に含めるためのフラグ。

    • “OutputDir”——生成されたファイルを含む出力ディレクトリへのパス。

    • “PackageName”——生成されたパッケージの名前。

    • “SampleGenerationFiles”——サンプルPythonパッケージファイルの生成に使用されるMATLABサンプルファイル。詳細については,サンプルドライバーファイルの作成を参照してください。

    • “详细”——ビルドプロセス中にコンパイラ出力を示す進行状況の情報を表示するためのフラグ。

MATLABにより生成されたPythonアプリケーションのインストールと実行

Pythonパッケージの作成後,Pythonアプリケーションからこれを呼び出すことができます。作成するPythonアプリケーションでは,パッケージ化の際に生成されたサンプルPythonドライバーコードを使用します。このPythonドライバーコードはPythonパッケージを呼び出し,以前のセットアップ手順で選択したサンプルMATLABファイルを基にしています。

これらの手順は,GettingStarted.htmlファイルでも説明されています。開始する前に,MATLAB运行时のインストールと構成が完了していて,Pythonがインストールされていることを確認してください。

  1. 生成されたPythonドライバーコードファイルmakesqrSample1.pyを样品フォルダーからコピーして,setup . pyファイルを含むフォルダーに貼り付けます。

  2. システムのコマンドラインを使用して,生成されたサンプルPythonドライバーコードファイルとsetup . pyを含むフォルダーに移動します。

  3. システムのコマンドプロンプトでpythonを使用して,アプリケーションをインストールします。

    python setup . py install

  4. システムのコマンドプロンプトからアプリケーションを実行します。

    python makesqrSample1.py

    メモ

    macOSでは,mwpythonスクリプトを使用しなければなりません。mwpythonスクリプトはmatlabroot/ binフォルダーにあります。matlabrootはMATLABがインストールされている場所です。

    たとえば,mwpython makesqrSample1.pyなどです。

参考

||||

MATLAB编译器SDKドキュメンテーション

サポート

仿真软件MAT金宝appLAB,その他の製品をお試しください

無料評価版のダウンロード