「パッケージのビルド」の版間の差分
編集の要約なし |
編集の要約なし |
||
| (同じ利用者による、間の9版が非表示) | |||
| 1行目: | 1行目: | ||
{{Alert|この記事のより新しい版が[https://docs.wsoft.ws/products/alice/tutorial/build/ WSOFTDocs]にあります。AliceScriptWikiでは、この記事はもう更新されません。||04}} | |||
[[Category:チュートリアル]] | [[Category:チュートリアル]] | ||
あなたが作成したスクリプトをAlicePackage形式のアプリケーションとして展開するには、AlicePackage形式にビルドする必要があります。 | あなたが作成したスクリプトをAlicePackage形式のアプリケーションとして展開するには、AlicePackage形式にビルドする必要があります。 | ||
| 7行目: | 9行目: | ||
=IceBuild= | =IceBuild= | ||
AlicePackage Build | AlicePackage Build Environmentは、[[AlicePackage]]形式のアプリケーションをビルドするためのプラットフォームです。IceBuildとも呼ばれるこのエンジンは、パッケージを処理およびビルドする方法を制御する方法を提供します。 | ||
ディレクトリに対して<code>icebuild.ice</code>を実行するとAlicePackageを簡単に出力できます。 | ディレクトリに対して<code>icebuild.ice</code>を実行するとAlicePackageを簡単に出力できます。 | ||
IceBuildは、[[AliceScriptのダウンロード#その他のファイルのダウンロード|AliceScriptのダウンロード]]の記事からダウンロードできます。 | |||
IceBuildは、ビルドする前にパッケージマニフェストファイルを確認し、適切なエントリポイントが指定されているか、埋め込まれたリソースファイルが存在するかなどの基本的な事項を確認した後パッケージのビルドを開始します。ビルドスクリプトの使用が特に必要な場合を除いて、基本的にAlicePackageのビルドにはIceBuildを使用することを推奨します。 | IceBuildは、ビルドする前にパッケージマニフェストファイルを確認し、適切なエントリポイントが指定されているか、埋め込まれたリソースファイルが存在するかなどの基本的な事項を確認した後パッケージのビルドを開始します。ビルドスクリプトの使用が特に必要な場合を除いて、基本的にAlicePackageのビルドにはIceBuildを使用することを推奨します。 | ||
| 14行目: | 17行目: | ||
IceBuildを使用するには、適切なコマンドライン引数とともに、適切なディレクトリ名を<code>icebuild.ice</code>に渡します。例えば、ディレクトリ<code>TestPkg</code>から<code>TestPkg.ice</code>をビルドするには、次のコマンドを使用します。 | IceBuildを使用するには、適切なコマンドライン引数とともに、適切なディレクトリ名を<code>icebuild.ice</code>に渡します。例えば、ディレクトリ<code>TestPkg</code>から<code>TestPkg.ice</code>をビルドするには、次のコマンドを使用します。 | ||
icebuild.ice TestPkg -out:TestPkg.ice | icebuild.ice TestPkg -out:TestPkg.ice | ||
.iceファイルをコマンドプロンプトから実行できるようにするには、[ | IceBuildのコマンドライン引数について詳しく知るには[[IceBuildコマンドラインリファレンス]]を参照してください。 | ||
.iceファイルをコマンドプロンプトから実行できるようにするには、[https://docs.wsoft.ws/products/alice/tutorial/ice-to-association/ チュートリアル:iceファイルの関連付け]を参照してください。 | |||
==AliceScriptから使用する== | ==AliceScriptから使用する== | ||
AliceScriptからIceBuildを呼び出すこともできます。この方法を使用して、IceBuildの安定性とビルドスクリプトを一から実行することのメリットを同時に享受することができます。この方法を使用するときは、例えば次の状況が考えられます。 | |||
*パッケージ化する前に、ファイルまたはディレクトリに前処理することを希望している | *パッケージ化する前に、ファイルまたはディレクトリに前処理することを希望している | ||
*ビルドが成功したとき、出力されたパッケージを別の場所にコピーすることを希望している | *ビルドが成功したとき、出力されたパッケージを別の場所にコピーすることを希望している | ||
*ビルド後に後処理を実行することを希望している | *ビルド後に後処理を実行することを希望している | ||
次の例は、AliceScriptでIceBuildを呼び出すサンプルです。 | 次の例は、AliceScriptでIceBuildを呼び出すサンプルです。 | ||
import | import “icebuild.ice”; | ||
using WSOFT.AliceScript.IceBuild; | using WSOFT.AliceScript.IceBuild; | ||
| 52行目: | 58行目: | ||
//希望する場合はビルド完了時の後処理を記述 | //希望する場合はビルド完了時の後処理を記述 | ||
print(“パッケージのビルドが完了しました”); | print(“パッケージのビルドが完了しました”); | ||
=ビルドスクリプトを一から作成する= | =ビルドスクリプトを一から作成する= | ||
また、<code>Alice.Packaging</code>名前空間にあるクラスを使用して自分で一からパッケージをビルドするスクリプトを作成することもできます。 | また、<code>Alice.Packaging</code>名前空間にあるクラスを使用して自分で一からパッケージをビルドするスクリプトを作成することもできます。 | ||
| 58行目: | 65行目: | ||
#<code>manifest.xml</code>を含むビルド対象のディレクトリをZip形式で圧縮する | #<code>manifest.xml</code>を含むビルド対象のディレクトリをZip形式で圧縮する | ||
#1のファイルをAlicePackage形式に変換する | #1のファイルをAlicePackage形式に変換する | ||
このままでもAlicePackage形式として実行可能ですが、できる限りパッケージ化前に少なくともパッケージマニフェストファイルの簡易チェックをしてください。ユーザーおよび開発者はAlicePackageに正しい内容のパッケージマニフェストファイルが含まれていることを期待しますし、実際にそのようなプログラムが流行することはAliceエコシステムの健全な成長を妨げかねません。 | |||
次の例はビルドスクリプトの一例です。 | 次の例はビルドスクリプトの一例です。 | ||
import “Alice.IO”; | import “Alice.IO”; | ||