アプリケーションのカスタマイズ

アプリケーションをカスタマイズする方法は複数あります。具体的には、[アプリケーションコンパイラ] アプリまたは [ライブラリコンパイラ] アプリを使用して、インストーラーのカスタマイズ、プロジェクトのファイルの管理、カスタムインストーラーパスの追加を行います。

インストーラーのカスタマイズ

アプリケーションアイコンの変更

既定のアイコンを変更するには、[ライブラリ名] または [アプリケーション名] フィールドの左にあるグラフィックスをクリックして、アイコンのプレビューを表示します。

[アイコンの選択] をクリックして、アプリケーションアイコンとして使用するグラフィックスファイルを指定します。[マスクの使用] オプションを選択すると、アイコンの周囲の空白が白で塗りつぶされます。また、[境界線の使用] オプションを選択すると、アイコンの周囲に境界線が追加されます。

メインウィンドウに戻るには、[保存して使用] をクリックします。

ライブラリまたはアプリケーション情報の追加

アプリケーションに関する以下の追加情報を入力できます。

ライブラリ/アプリケーション名: インストールする MATLAB^® アーティファクトの名前。たとえば、この名前を foo にすると、インストールされる実行可能ファイルは foo.exe となり、Windows^® スタートメニューの項目は [foo] となります。アプリケーション用に作成されるフォルダーは InstallRoot/foo になります。
既定値は、アプリの [メインファイル] フィールドでリストの先頭に表示される関数の名前です。
バージョン: 既定値は 1.0 です。
作成者名: 開発者の名前。
サポート用の電子メールアドレス: 連絡先情報に使用する電子メールアドレス。
会社名: インストールする MATLAB アーティファクトの絶対インストールパス。たとえば、会社名が bar である場合、絶対インストールパスは InstallRoot/bar/ApplicationName となります。
概要: アプリケーションの内容を示す簡単な概要。
説明: アプリケーションの詳細な説明。

情報はすべて任意指定であり、別途指定されている場合を除き、インストーラーの最初のページにのみ表示されます。Windows システムでは、これらの情報は Windows コントロールパネルの [プログラムの追加と削除] にも表示されます。

スプラッシュスクリーンの変更

インストーラーのスプラッシュスクリーンはインストーラーの起動後に表示されます。これはインストーラーの初期化中にステータスバーと共に表示されます。

既定のイメージは、[カスタムスプラッシュスクリーンの選択] をクリックして変更できます。ファイルエクスプローラーが開いたら、新しいイメージを見つけて選択してください。

カスタムイメージを既定のスプラッシュスクリーンにドラッグアンドドロップできます。

インストールパスの変更

次の表は、パッケージ化されたバイナリをターゲットシステムにインストールする場合にインストーラーが使用する既定のパスを示しています。

Windows	`C:\Program Files\companyName\appName`
Mac OS X	`/Applications/companyName/appName`
Linux^®	`/usr/companyName/appName`

既定のインストールパスは、[追加インストーラーオプション] の下の [既定のインストールフォルダー] フィールドを編集して変更できます。

ルートフォルダーに付加されるパスを指定するテキストフィールドがインストールフォルダーです。アプリケーションのインストールフォルダーにルートフォルダーを選択することができます。次の表は、プラットフォームごとのオプションのカスタムルートフォルダーを示しています。

Windows	`C:\Users\userName\AppData`
Linux	`/usr/local`

ロゴの変更

ロゴはインストーラーの起動後に表示されます。インストーラーの右側に表示されます。

既定のイメージは、[追加インストーラーオプション] の [カスタムロゴの選択] をクリックして変更できます。ファイルエクスプローラーが開いたら、新しいイメージを見つけて選択してください。カスタムイメージを既定のロゴにドラッグアンドドロップできます。

インストールメモの編集

インストールメモは、パッケージ化されたファイルがインストーラーによってターゲットシステムに正常にインストールされると表示されます。インストールされたバイナリを使用するために必要な追加セットアップについての役立つ情報や、アプリケーションの実行方法に関する説明を提供できます。

コマンドライン入力のデータ型の決定 (スタンドアロンアプリケーションのパッケージ化の場合のみ)

実行可能スタンドアロンアプリケーションをコマンドプロンプトで実行する場合、既定の入力の型は char です。この既定の設定をそのまま使用するか、すべての入力を MATLAB double の数値として解釈させることができます。

入力を MATLAB の文字ベクトルとしてスタンドアロンアプリケーションに渡すには、[アプリへのすべての入力を MATLAB の文字ベクトルとして扱います。] を選択します。この場合、char を数値 MATLAB 型に変換するためのコードを、スタンドアロンアプリケーションとしてデプロイする MATLAB 関数に含めなければなりません。

入力を数値の MATLAB 変数としてスタンドアロンアプリケーションに渡すには、アプリケーションコンパイラアプリで [アプリへのすべての入力を MATLAB の double の数値として扱います。] オプションを選択します。これにより、char を数値 MATLAB 型に変換するコードを含める必要はなくなります。アプリケーションに数値以外を入力すると、エラーの発生する場合があります。

コンパイラプロジェクトの必須ファイルの管理

コンパイラでは、依存関係解析関数を使用して、アプリケーションをパッケージ化し実行するために必要な追加の MATLAB ファイルが自動的に判定されます。こうしたファイルは自動的にパッケージ化され、生成されるバイナリに組み込まれます。コンパイラでは、必要なファイルで定義される関数への直接アクセスを可能にするラッパーコードは生成されません。

いずれかのコンパイラアプリを使用する場合は、依存関係解析関数によって検出された必要なファイルが [アプリケーションの実行に必要なファイル] または [ライブラリの実行に必要なファイル] フィールドに一覧表示されます。

ファイルを追加するには、フィールドの [+] ボタンをクリックして、ファイルをファイルエクスプローラーで選択します。ファイルを削除するには、ファイルを選択して Delete キーを押します。

注意

必要なファイルのリストからファイルを削除すると、アプリケーションがパッケージ化されなくなったり、デプロイされたときに正しく実行されなくなったりすることがあります。

`mcc` の使用方法

mcc を使用して MATLAB コードをパッケージ化する場合、必要なファイルのリストが実行前にコンパイラで表示されることはありません。その代わりに、依存関係解析関数によって検出された必要なファイル全部がパッケージ化されて、生成されるバイナリファイルに追加されます。

ファイルをリストに追加するには、1 つ以上の -a 引数を mcc に渡します。-a 引数は、指定されたファイルをファイルのリストに加え、生成されるバイナリに追加されるようにします。たとえば、-a hello.m はファイル hello.m を必要なファイルのリストに追加し、-a ./foo は foo とそのサブフォルダー内のすべてのファイルを必要なファイルのリストに追加します。

サンプルドライバーファイルの作成

サンプルドライバーファイルを使用して、生成されたコンポーネントをターゲット言語のアプリケーションに実装します。

次のターゲットタイプでは、MATLAB Compiler SDK™ でのサンプルドライバーファイルの作成をサポートします。

C++ 共有ライブラリ
Java^® パッケージ
.NET アセンブリ
Python^® パッケージ

[ライブラリコンパイラ] のサンプルファイル作成機能では、MATLAB コードを使用して、サンプルファイルをターゲット言語で生成します。アプリで、[新規サンプルの作成] をクリックして新規 MATLAB スクリプトを自動的に生成するか、[既存のサンプルの追加] をクリックして、既に記述した MATLAB スクリプトをアップロードします。関数のパッケージ化が完了したら、ターゲット言語でのサンプルファイルが MATLAB スクリプトから生成され、samples という名前のフォルダーに保存されます。サンプルファイルはインストーラーにも含まれています。

新規 MATLAB ファイルを自動的に生成するには、[新規サンプルの作成] をクリックします。これにより、MATLAB ファイルが編集用に開きます。サンプルファイルを開始点として利用し、エクスポートする関数の動作に基づいて、必要に応じてユーザーが編集する必要があります。

サンプル MATLAB ファイルは次のガイドラインに従わなければなりません。

サンプルファイルは、関数ではなく MATLAB スクリプトでなければならない。
サンプルファイルコードでは、エクスポートする関数のみを使用しなければならない。スクリプトで呼び出されたすべてのユーザー定義関数は、最上位のエクスポートされた関数でなければならない。
エクスポートする関数への呼び出しは、それぞれ別々のサンプルファイル内になければならない。
エクスポートする同じ関数への呼び出しは、それぞれ別々のサンプルファイルでなければならない。
最上位関数の入力パラメーターは、プロセス中に分析される。入力パラメーターを struct 内のフィールドにすることはできない。
エクスポートする関数の出力は、n 次元の数値、char、logical、struct、cell 配列のいずれかでなければならない。
データはローカル変数として保存してから、エクスポートする関数にサンプルファイルコード内で渡さなければならない。
サンプルファイルコードでユーザーの操作を必要としてはならない。
サンプルスクリプトは、ターゲット言語のサンプルコードを生成するプロセスの一部として実行される。実行中にエラーがあると (未定義の変数など) サンプルは生成されなくなるが、ビルドターゲットは引き続き生成される。

ターゲット言語固有の追加の考慮事項は次のとおりです。

C++ mwArray API — varargin と varargout はサポートされません。
.NET — タイプセーフ API はサポートされていません。
Python — cell 配列と char 配列はサイズが 1 行 N 列でなければならず、struct 配列はスカラーでなければなりません。数値配列や logical 配列は、MATLAB の場合と同様に方形配列でなければなりませんが、それ以外の制限はありません。

既に記述した MATLAB ファイルをアップロードするには、[既存のサンプルの追加] をクリックします。MATLAB コードは、エクスポートされた関数の実行方法を示さなければなりません。必要な MATLAB コードは、わずか数行の場合もあります。

input1 = [1 4 7; 2 5 8; 3 6 9];
input2 = [1 4 7; 2 5 8; 3 6 9];
addoutput = addmatrix(input1,input2);

また、このコードは、[新規サンプルの作成] オプションについて概説したものとまったく同じガイドラインに従わなければなりません。

MATLAB サンプルファイルを既に作成している場合は、'SampleGenerationFiles' オプションを使用してサポートされているターゲットの関数 compiler.build に含めることができます。

パッケージ化手順で、サンプルファイルをまったく含めないように選択することもできます。ターゲット言語での独自のコードを作成した場合、MATLAB 関数のパッケージ化が完了してから、後で適切なディレクトリにコピーして貼り付けることができます。

アプリケーションと共にインストールするファイルの指定

コンパイラでは、生成されるファイルと共にインストールするファイルがパッケージ化されます。既定の設定では、MATLAB Runtime のインストールと構成に関する説明を含む Readme ファイルがインストーラーに組み込まれます。

こうしたファイルは、アプリの [エンドユーザー用にインストールされるファイル] セクションに表示されます。

ファイルをリストに追加するには、をクリックして、ファイルをファイルエクスプローラーから選択します。

javaaddpath を呼び出した場合と同様に、JAR ファイルがアプリケーションクラスパスに追加されます。

注意

バイナリターゲットをリストから削除すると、意図した機能がインストーラーによってインストールされなくなります。

[エンドユーザー用にインストールされるファイル] に表示されているファイルは、ターゲットコンピューターにインストールされる際、application フォルダーに保存されます。

ランタイム追加設定

パッケージ化されたアプリケーションの種類	説明	ランタイム追加設定オプション
スタンドアロンアプリケーション	Windows の実行コマンドシェル (コンソール) を表示しない — このオプションを Windows プラットフォームで選択した場合、ファイルエクスプローラーでアプリケーションをダブルクリックすると、アプリケーションウィンドウは開きますがコマンドプロンプトは開きません。ログファイルの作成 — アプリケーションの MATLAB ログファイルを生成します。パッケージ化されたアプリケーションが Windows の `C:` フォルダーにインストールされている場合、ログファイルを作成できません。これは、アプリケーションにそのフォルダーへの書き込み権限がないためです。
Excel アドイン	コンポーネントを現在のユーザーに対して登録します (管理者以外のユーザーに推奨) — このオプションは現在のユーザーアカウント用にコンポーネントの登録を有効にします。これは、管理者権限のないユーザー向けに提供されています。ログファイルの作成 — アプリケーションの MATLAB ログファイルを生成します。パッケージ化されたアプリケーションが Windows の `C:` フォルダーにインストールされている場合、ログファイルを作成できません。これは、アプリケーションにそのフォルダーへの書き込み権限がないためです。