AlicePackage

AlicePackageは、プログラムのスクリプト、リソース、ライブラリやパッケージを含むAliceModelで実行できるアプリパッケージ形式です。

AlicePackageファイルはそのマジックナンバー「ICE」（16進表現で49 43 45とパッケージタイプを表す1バイトで識別できます。

AlicePackageを作成する方法について知るには、パッケージのビルドを参照してください。

はじめに

AlicePackageは、AliceScriptで書かれたプログラムとリソース、ライブラリや他のパッケージをひとつにまとめたアプリケーションの形式です。

ファイル構造

AlicePackageのファイルフォーマットを以下に示します。

ファイルスイッチ

ファイルスイッチは、パッケージ前方にある8ビット(1バイト)の領域です。それぞれのビットには、パッケージの性質を表すフラグが含まれます。

ファイルスイッチ

制御コード

AlicePackageのヘッダーに含まれる16バイトの領域は制御コードと呼ばれ、この領域を直接AliceModelが使用することはありません。しかし、AliceModelを実装するそれぞれのインタプリタによって使用される場合があります。この領域の標準的な使用方法はどのAliceModelの実装を使用しているかを識別するのに使用されます。

署名

AlicePackageにデジタル署名を添付することで、そのパッケージファイルが改竄されておらず、正しい提供元から提供されていることを確認できます。署名されたAlicePackageは、未書名のパッケージファイルに比べて実行されるまで時間がかかります。署名済みAlicePackageのファイルスイッチには1が立ちます。

署名するAlicePackageには、パッケージコンテナーの最上部にcertificate.pfxファイルを(このままの名前で)配置する必要があります。PFXファイルは、パッケージの検証に必要な証明書を表すファイルです。署名の検証はパッケージマニフェストファイルが読み込まれる前に読み込まれます。

パッケージマニフェストファイル

すべてのパッケージは、パッケージコンテナーの最上部にmanifest.xmlファイルを（このままの名前で）配置する必要があります。パッケージマニフェストファイルは、パッケージに関する情報をビルドツールやAlice.Interpreterに説明するものです。まずは次の例を参照してください。

<?xml version="1.0" encoding="utf-8"?>
  <package>
    <name>Hello,Package</name>
    <version>1.0</version>
    <publisher>WSOFT</publisher>
    <description>Hello,World!とだけ表示します</description>
    <script>
      print("Hello,World!");
    </script>
    <target>any</target>
 </package>

パッケージマニフェストファイルは、XML形式で、少なくとも次の情報を記述する必要があります。

Name属性

Name属性は、このパッケージの名前を表します。

Script属性

Script属性は、このパッケージのエントリポイントを表します。このパッケージが読み込まれたとき、AliceScriptインタプリタはエントリポイントに記述された内容を順番に実行します。 Script属性の指定には、インラインスクリプトを使用する方法と、有効なスクリプトへのリンクを使う方法の二通りがあります。たとえば、別のスクリプトファイルであるmain.aliceをエントリポイントとして使用するには、次のように指定します。

• ファイルを指定する例

<?xml version="1.0" encoding="utf-8"?>
<package>
    <name>Hello,Package</name>
    <script path="main.alice" />
</package>

インラインスクリプトは次のような形式になります。

• インラインスクリプトを指定する例

<?xml version="1.0" encoding="utf-8"?>
<package>
    <name>Hello,Package</name>
    <script>
      print("Hello,World!");
    </script>
</package>

アプリケーション内のリソースにアクセスする

パッケージ内のコードからAlicePackageに含めたファイルを読み込むには、file_read_text関数またはfile_read_data関数を使用します。この関数の詳しい説明はそれぞれの記事をご覧ください。

ここでは、例としてパッケージ内に存在する.NETのアセンブリを読み込むコードを次に示します。

using Alice.IO;
using Alice.Interop;

// 読み込むライブラリのファイル名
const LIBRARY_PATH = "myAssembly.dll";

// パッケージ内のファイルをデータ形式で読み込む
var asm = file_read_data(LIBRARY_PATH, true);

// 読み込んだファイルをライブラリとして読み込む
interop_loadLibrary(asm);

作成したライブラリを読み込む

すでにAlicePackage形式で作成されているライブラリを読み込むには、import関数を使用します。

次に、ライブラリを読み込んでその中の関数を使用する例を示します。

import("MyLibrary.ice");

using MyLibrary;

Func();