Platform-specific Resources - 特定のプラットフォーム向けリソースの設定

Aplite、Basalt、Chalk のいずれか 1 つ以上のプラットフォームで、異なるバージョンのリソースを使用したい場合があります。これを可能にするため、リソース ファイルに、特定のプラットフォームに関連する属性で「タグ付け」できるようになりました。

各プラットフォームには次のタグが存在します：

リソースにタグを付けるには、ファイル名の後にチルダ（~）を使用してタグを追加します。たとえば、example-image~color.png とすると、カラー プラットフォームでのみリソースが使用され、example-image~color~round.png とすると、ラウンドでカラーのディスプレイを持つプラットフォームでのみリソースが使用されます。ファイルが使用されるには、すべてのタグが一致する必要があります。プラットフォームに一致するファイルがない場合、コンパイル エラーが発生します。

プラットフォームに適したファイルが曖昧な場合、コンパイル時にエラーが発生します。たとえば、example~color.png と example~round.png の両方を持つことはできません。Chalk 用にビルドする際に、どちらの画像を使用するかが不明確だからです。代わりに、example~color~rect.png と example~round.png を使用してください。複数の画像が一致する可能性がある場合は、タグが最も多いものが優先されます。

プラットフォーム固有のタグ（aplite、basalt など）は避けることをお勧めします。将来新しいプラットフォームをリリースする際に、そのプラットフォーム用の新しいファイルを作成する必要があります。ただし、説明的なタグを使用すると、適切に自動的に使用されます。また、プラットフォームタグは特別ではないことも注目に値します：example~basalt.png と example~rect.png がある場合、これは曖昧（両方とも Basalt に一致）であり、コンパイル エラーが発生します。

ファイル構造の例を以下に示します。

my-project/
  resources/
    images/
      example-image~bw.png
      example-image~color~rect.png
      example-image~color~round.png
  src/
    main.c
  package.json
  wscript

このリソースは、以下のように package.json に表示されます。

"resources": {
  "media": [
    {
      "type": "bitmap",
      "name": "EXAMPLE_IMAGE",
      "file": "images/example-image.png"
    }
  ]
}

単一プラットフォームのリソース

特定のプラットフォームにのみリソースを含めたい場合は、package.json の media 配列内のリソースのエントリに targetPlatforms フィールドを追加できます。たとえば、以下に示すリソースは Basalt ビルドにのみ含まれます。

"resources": {
  "media": [
    {
      "type": "bitmap",
      "name": "BACKGROUND_IMAGE",
      "file": "images/background.png",
      "targetPlatforms": [
        "basalt"
      ]
    }
  ]
}