AlicePackage

この記事では、AlicePackageの仕様について説明します

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

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

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

ファイル構造

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>