これがないドキュメントの最新バージョンです！ Click here for the latest released version.

Config.xml ファイル

グローバル構成ファイルを使って、アプリの動作の多くの側面を制御できる config.xml 。このプラットフォームに依存しない XML ファイルは、W3C のWeb アプリのパッケージ化 (ウィジェット)仕様に基づくとコルドバ API のコア機能、プラグイン、およびプラットフォームに固有の設定を指定する拡張に配置されます。

コルドバ CLI (コマンドラインインターフェイスで説明します) で作成されたプロジェクトのトップレベルディレクトリにこのファイルを検出することができます。

    app/config.xml

バージョン 3.3.1-0.2.0 の前に、ファイルに存在したことに注意してください app/www/config.xml 、ここでそれを持っているがまだサポートされているとします。

プロジェクトをビルドする CLI を使用して、このファイルのバージョン受動的にコピーされます様々な platforms/ サブディレクトリ、たとえば。

    app/platforms/ios/AppName/config.xml
    app/platforms/blackberry10/www/config.xml
    app/platforms/android/res/xml/config.xml

このセクションとクロスプラットフォームのグローバル構成オプションを詳細します。プラットフォーム固有のオプションの次のセクションを参照してください。

以下に詳述様々な構成のオプションに加え、アプリケーションのコアセット各ターゲット・プラットフォーム用の画像も構成できます。詳細については、アイコンとスプラッシュ画面を参照してください。

コア構成要素

この例では、既定の config.xml は CLI によって生成される create コマンドは、コマンドラインインターフェイスで記述されています。

    <widget id="com.example.hello" version="0.0.1">
        <name>HelloWorld</name>
        <description>
            A sample Apache Cordova application that responds to the deviceready event.
        </description>
        <author email="dev@callback.apache.org" href="http://cordova.io">
            Apache Cordova Team
        </author>
        <content src="index.html" />
        <access origin="*" />
    </widget>

次の構成要素は最上位レベルに表示されます config.xml ファイル、およびすべてのサポートされているコルドバプラットフォームがサポートされています。

<widget>要素の id 属性をアプリの逆ドメイン識別子を提供します、 version その完全なバージョン番号のメジャー/マイナー/パッチ表記で表されます。
<name>要素をデバイスのホーム画面とアプリストアインターフェイス内が表示されますアプリケーションの正式な名前を指定します。
<description>と <author> 要素メタデータおよび app の店のリスト内に表示される連絡先の情報を指定します。
省略可能な <content> 要素を最上位の web 資産ディレクトリで、アプリの開始ページを定義します。既定値は index.html 、トップレベルのプロジェクトで表示される習慣 www ディレクトリ。
<access>要素は外部ドメインのアプリケーション通信を許可するとのセットを定義します。上記の既定値の任意のサーバーにアクセスすることができます。詳細についてはドメインホワイトリストガイドを参照してください。
<preference>タグのペアとして様々なオプションを設定します name / value の属性。各設定項目 name 小文字は区別されません。多くの設定は、このページの上部に記載されている特定のプラットフォームに固有です。次のセクションでは、1 つ以上のプラットフォームに適用される設定を詳細します。

グローバル設定

次のグローバル設定がすべてのプラットフォームに適用されます。

Fullscreen画面の上部のステータスバーを非表示にすることができます。既定値は false です。例:
```
<preference name="Fullscreen" value="true" />
```
Orientation向きをロックし、インターフェイスから回転の向きの変更に応答しないようにすることができます。可能な値は default 、 landscape 、または portrait 。例:
```
<preference name="Orientation" value="landscape" />
```
注: default 値は横向きと縦向きの両方が有効になっていることを意味します。各プラットフォームの既定の設定 (通常肖像画のみ) を使用する場合のままにこのタグのうち、 config.xml ファイル。

マルチプラットフォーム環境の設定

次の設定を 1 つ以上のプラットフォームができないそれらのすべてが適用されます。

DisallowOverscroll(ブール値、既定値は false ): に設定されている true ユーザーは過去の先頭または末尾のコンテンツのスクロール時に任意のフィードバックを表示するインターフェイスをしたくないかどうか。
```
<preference name="DisallowOverscroll" value="true"/>
```
人造人間と iOS に適用されます。 IOS の overscroll ジェスチャー原因コンテンツは元の位置に戻って跳ねます。 Android 上で彼らはコンテンツの上部または下部のエッジに沿ってより微妙な光る効果を生成します。
BackgroundColor: アプリケーションの背景色を設定します。次の 3 バイトは、アルファチャネルを表す最初のバイトと 4 バイトの 16 進値と標準の RGB 値をサポートしています。この例では、青を指定します。
```
<preference name="BackgroundColor" value="0xff0000ff"/>
```
アンドロイドおよびブラックベリーに適用されます。たとえば、すべてのプラットフォームそれ以外の場合利用可能な CSS をオーバーライドします。body{background-color:blue}.
HideKeyboardFormAccessoryBar(ブール値、既定値は false ): に設定されている true 貢献、キーボード上に表示される追加のツールバーを非表示にするユーザーを別の 1 つのフォーム入力から移動します。
```
<preference name="HideKeyboardFormAccessoryBar" value="true"/>
```
IOS とブラックベリーに適用されます。

機能要素

使用して、CLI を使用してアプリケーションを構築する場合、 plugin デバイス Api を有効にするコマンド。これは、最上位レベルは変更されません config.xml ファイル、そう、 <feature> 要素をワークフローに適用されません。 SDK およびプラットフォーム固有の使用で直接作業した場合 config.xml ファイルのソースとして使用する、 <feature> デバイスレベルの Api と外部プラグインを有効にするタグ。プラットフォーム固有のカスタム値とともに表示されます多くの場合 config.xml ファイル。たとえば、ここで Android プロジェクト用デバイス API を指定する方法は。

    <feature name="Device">
        <param name="android-package" value="org.apache.cordova.device.Device" />
    </feature>

ここでは、iOS のプロジェクトのための要素の表示方法です。

    <feature name="Device">
        <param name="ios-package" value="CDVDevice" />
    </feature>

各機能を指定する方法の詳細については API リファレンスを参照してください。プラグインの詳細については、プラグイン開発ガイドを参照してください。

Config.xml ファイル

コア構成要素

グローバル設定

マルチプラット フォーム環境の設定

機能要素

マルチプラットフォーム環境の設定