ミニプログラムのグローバル構成

ミニプログラムのルート ディレクトリにあるapp.jsonファイルは、WeChat ミニプログラムをグローバルに構成するために使用されます。ファイルの内容は、次のプロパティを持つ JSON オブジェクトです。

構成項目

ページ

ミニプログラムを構成するページを指定するために使用します。各項目は、ページのパス (ファイル名を含む) 情報に対応します。ファイル名にファイルサフィックスを付ける必要はありません。フレームワークは、対応する場所の.json 、 .js 、 .wxml 、および.wxssファイルを自動的に検索して処理します。

配列の最初の項目は、ミニプログラムの初期ページ (ホームページ) を表します。アプレット内のページを追加または削減するには、ページ配列を変更する必要があります。

たとえば、開発ディレクトリは次のようになります。

 ├── app.js
├── app.json
├── app.wxss
├── ページ
│ │── インデックス
│ │ ├── index.wxml
│ │ ├── index.js
│ │ ├── index.json
│ │ └── index.wxss
│ └── ログ
│ ├── ログ.wxml
│ └── ログ.js
└──ユーティリティ

app.jsonに記述する必要があります

{
  "ページ": ["ページ/インデックス/インデックス", "ページ/ログ/ログ"]}

ウィンドウ

ミニプログラムのステータス バー、ナビゲーション バー、タイトル、ウィンドウの背景色を設定するために使用されます。

• 注 1: HexColor (16 進数の色値)、例: "#ff00ff"
• 注2: navigationStyleについて
  • 7.0.0 未満のクライアント バージョンの場合、 navigationStyleはapp.jsonでのみ有効です。
  • クライアントバージョン6.7.2以降、 navigationStyle: custom Webビューコンポーネントでは無効です。
  • カスタムをオンにした後は、下位バージョンのクライアントとの互換性が必要になります。開発者ツールのベースライブラリバージョンは、古いビジュアルへの切り替えを容易にするために、1.7.0（最小バージョンではなく、デバッグのみ）に切り替えられました。

のように：

 {
  「ウィンドウ」: {
    "ナビゲーションバーの背景色": "#ffffff",
    "ナビゲーションバーのテキストスタイル": "黒",
    "navigationBarTitleText": "WeChat API 関数のデモンストレーション",
    "背景色": "#eeeeee",
    "backgroundTextStyle": "light"
  }}

タブバー

ミニプログラムがマルチタブ アプリケーション (ページを切り替えるためのタブ バーがクライアント ウィンドウの下部または上部にある) である場合は、tabBar 構成項目を使用して、タブ バーのパフォーマンスと、タブを切り替えるときに表示される対応するページを指定できます。

リストは配列を受け入れ、最小 2 個、最大 5 個のタブのみを構成できます。タブは配列の順序でソートされ、各項目は次のプロパティ値を持つオブジェクトです。

ネットワークタイムアウト

さまざまなネットワーク要求のタイムアウト（ミリ秒単位）。

デバッグ

開発者ツールでdebugモードを有効にすることができます。開発者ツールのコンソール パネルでは、ページ登録、ページ ルーティング、データ更新、イベント トリガーなどのデバッグ情報がinfoの形式で表示されます。開発者が一般的な問題を素早く見つけるのに役立ちます。

機能ページ

サポートは基本ライブラリ 2.1.0 から利用可能であり、下位バージョンとの互換性が必要です。

プラグイン所有者アプレットは、プラグイン機能ページを有効にするためにこれを設定する必要があります。

サブパッケージ

WeChatクライアント6.6.0、基本ライブラリ1.7.3以上のバージョンをサポート

サブパッケージの読み込みが有効になっている場合は、プロジェクトのサブパッケージ構造を宣言します。

サブパッケージもサポートされています。

労働者

サポートは基本ライブラリ 1.9.90 から利用可能であり、それより低いバージョンでも互換性が必要です。

Workerを使用してマルチスレッドタスクを処理する場合は、 Workerコードが配置されるディレクトリを設定します。

必須の背景モード

WeChatクライアント6.7.2以上でサポートされています

バックグラウンド実行機能の必要性を宣言します。型は配列です。現在、次のプロジェクトがサポートされています。

• audio : バックグラウンドミュージックの再生
• location : 背景の場所

のように：

 {
  "ページ": ["ページ/インデックス/インデックス"],
  "requiredBackgroundModes": ["オーディオ", "場所"]}

注: ここではバックグラウンド操作のインターフェースについて説明します。開発版と試用版では直接有効にできますが、正式版はまだ審査に合格する必要があります。

プラグイン

サポートは基本ライブラリ 1.9.6 から利用可能であり、それより低いバージョンでも互換性が必要です。

アプレットが使用する必要があるプラグインを宣言します。

プリロードルール

サポートは基本ライブラリ 2.3.0 から利用可能であり、下位バージョンとの互換性が必要です。

サブパッケージの事前ダウンロードのルールを宣言します。

サイズ変更可能

サポートは基本ライブラリ 2.3.0 から利用可能であり、下位バージョンとの互換性が必要です。

iPad で実行されるアプレットは、画面の回転をサポートするように設定できます。

ミニプログラムアプリIDリストへ移動

サポートは基本ライブラリ 2.4.0 から利用可能であり、下位バージョンとの互換性が必要です。

ミニプログラムが wx.navigateToMiniProgram インターフェイスを使用して他のミニプログラムにジャンプする必要がある場合、最初に構成ファイルでジャンプする必要があるミニプログラムの appId リストを宣言する必要があります。最大 10 項目まで許可されます。

コンポーネントの使用

開発者ツール 1.02.1810190 以降をサポート

ここで宣言されたカスタム コンポーネントはグローバル カスタム コンポーネントと見なされ、追加の宣言なしでミニプログラム内のページまたはカスタム コンポーネントで直接使用できます。

許可

WeChatクライアント7.0.0以上でサポートされています

ミニプログラムインターフェースの権限関連の設定。フィールド タイプはObjectであり、構造は次のとおりです。

PermissionObject 構造

のように：

 {
  "ページ": ["ページ/インデックス/インデックス"],
  "許可"： {
    "スコープ.userLocation": {
      "desc": "あなたの位置情報は、ミニプログラムの位置インターフェースの効果を表示するために使用されます" // 高速道路を運転中の継続的な背景位置決め }
  }}

サイトマップ所在地

sitemap.json の場所を指定します。デフォルトは 'sitemap.json' で、app.json と同じディレクトリにあるsitemap.jsonという名前のファイルを意味します。

設定例

{
  "ページ": ["ページ/インデックス/インデックス", "ページ/ログ/インデックス"],
  「ウィンドウ」: {
    "navigationBarTitleText": "デモ"
  },
  "タブバー": {
    「リスト」: [
      {
        "ページパス": "ページ/インデックス/インデックス",
        "テキスト": "ホーム"
      },
      {
        "pagePath": "ページ/ログ/ログ",
        "text": "ログ"
      }
    ]
  },
  "ネットワークタイムアウト": {
    「リクエスト」: 10000,
    「ダウンロードファイル」: 10000
  },
  「デバッグ」：true、
  "ミニプログラムアプリIDリストへ移動": ["wxe5f52902cf4de896"]}

スタイル

サポートは基本ライブラリ 2.8.0 から利用可能であり、下位バージョンとの互換性が必要です。

WeChat クライアント 7.0 以降、UI インターフェースは大幅に改訂されました。ミニプログラムでは、基本コンポーネントのスタイルもアップグレードされました。 app.json で"style": "v2"を構成すると、コンポーネント スタイルの新しいバージョンが有効になっていることを示します。

この変更の影響を受けるコンポーネントはbutton icon radio checkbox switch sliderです。ミニプログラムの例を見て体験してみてください。

拡張ライブラリの使用

サポートは基本ライブラリ 2.2.1 から利用可能です。下位バージョンとの互換性が必要です。

開発者ツールの最新のナイトリーバージョンからサポートが開始され、基本ライブラリはnpmをサポートするバージョン（2.2.1）から開始されます。

参照する拡張ライブラリを指定します。現在、次のプロジェクトがサポートされています。

• kbone : マルチターミナル開発フレームワーク
• weui : WeUI コンポーネント ライブラリ

指定後は、該当拡張ライブラリに関連するnpmパッケージの最新バージョンを導入することと同等となり、ミニプログラムのパッケージサイズを占有しません。サブパッケージ内の参照は現在サポートされていません。使用方法は次のとおりです。

 {
  "useExtendedLib": {
    "kbone": 真、
    "weui": 真
  }}

入口宣言する

WeChatクライアント7.0.9以上でサポートされていますが、iOSではまだサポートされていません

チャットロケーションメッセージはタクシー呼び出しミニプログラムで開くことができます。詳細については詳細を参照してください。

 「入口宣言」: {
    「ロケーションメッセージ」: {
        "パス": "ページ/インデックス/インデックス",
        "クエリ": "foo=bar"

 }}