# config.xml

`config.xml` 設定ファイルを使用して、Cordova のさまざまな設定を管理します。

![](/files/-Mgd7gKD32_6zO2XaGyN)

設定可能な要素と preference を次に記します。必要に応じて設定します。

## \<widget> 要素

| 属性        | 型   | デフォルト値  | 解説                                         |
| --------- | --- | ------- | ------------------------------------------ |
| `version` | 文字列 | `1.0.0` | A version number which is visible to users |

**例**

```markup
<widget id="com.example.helloworld" version="0.0.1">
  ...
</widget>
```

## \<content> 要素

| 属性    | 型   | デフォルト値        | 解説                                                                                                                       |
| ----- | --- | ------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `src` | 文字列 | `indext.html` | `<content>` 要素では、アプリ起動時のページを指定します ( 通常、Web アセットを置いた、最上位のディレクトリーにこのページは置かれます )。 `src` 属性の値に、他の URL を指定すれば、起動時のページを変更できます。 |

**例**

```markup
<?xml version="1.0" encoding="UTF-8"?>
<widget xmlns="http://www.w3.org/ns/widgets" id="com.example.helloworld" version="1.0.0">
  ...
  <content src="https://monaca.io/" />
</widget>
```

## \<access> 要素

| 属性       | 型   | デフォルト値 | 解説                                                                    |
| -------- | --- | ------ | --------------------------------------------------------------------- |
| `origin` | 文字列 | `*`    | アクセスできるネットワークドメインを指定します。 `*` に指定した場合、どのドメインにも、アプリからアクセスできます。your app. |

**例**

```markup
...
<access origin="*" />
...
```

## \<preference> 要素

`<preference>` タグでは、name と value の組み合わせ形式で、オプションを設定します。preference の name では、大文字小文字は区別されません。preference の多くは、各プラットフォーム毎に設定する必要があります。次の preference に関しては、複数のプラットフォームに適用できます。

| Preference Name              | 型   | デフォルト値    | 解説                                                                                                                                                                                                                                                                                                                                                               |
| ---------------------------- | --- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `DisallowOverScroll`         | 真偽値 | `false`   | `true` に指定した場合、ラバーバンド スクロール ( rubber-band scrolling ) が無効になります。                                                                                                                                                                                                                                                                                                  |
| `EnableViewportScale`        | 真偽値 | `false`   | `true` に指定した場合、ビューポートのスケール方法を指定した `meta` タグを無視します。                                                                                                                                                                                                                                                                                                               |
| `AutoHideSplashScreen`       | 真偽値 | `true`    | `false` に指定した場合、JavaScript API を使用して、スプラッシュ画像の制御を行えます。                                                                                                                                                                                                                                                                                                           |
| `BackupWebStorage`           | 文字列 | `cloud`   | <p>次のいずれかの値を設定できます。 </p><p></p><ul><li><code>none</code>: バックアップを無効にします。</li><li><code>cloud</code>: iCloud へのバックアップを許可します。</li><li><code>local</code>: ローカルへのバックアップ ( iTunes Sync 経由 ) を許可します。</li></ul>                                                                                                                                                        |
| `UIWebViewDecelerationSpeed` | 文字列 | `normal`  | <p>慣性スクロールの減速度を指定します。2 つのオプションがあります。 </p><p></p><ul><li><code>normal</code>: デフォルトでは、こちらを選択します。</li><li><code>fast</code>: Mobile Safari の場合、こちらを選択します。</li></ul>                                                                                                                                                                                                |
| `Orientation`\*              | 文字列 | `default` | <p>画面のオリエンテーションを設定します。次の <code>4</code> つの値を設定できます。 </p><p></p><ul><li><code>all</code>: この設定では、portrait と landscape の両方を使用できます ( プラットフォーム毎の設定時に使用 )。</li><li><code>default</code>: システム側のデフォルトのオリエンテーションを使用します。</li><li><code>landscape</code>: landscape ( 横向き ) のオリエンテーションを使用します。</li><li><code>portrait</code>: portrait ( 縦向き ) のオリエンテーションを使用します。</li></ul> |

**例**

```markup
...
<preference name="DisallowOverscroll" value="false" />
<preference name="EnableViewportScale" value="false" />
<preference name="AutoHideSplashScreen" value="true" />
<preference name="BackupWebStorage" value="cloud" />
<preference name="UIWebViewDecelerationSpeed" value="normal" />
<preference name="Orientation" value="portrait" />
...
```

**\***: There are two use ways to configure `Orientation` preference:

1. 全プラットフォーム共通の設定方法

   ```markup
   <widget>
   ....
   <preference name="orientation" value="default"/>
   ....
   </widget>
   ```

{% hint style="info" %}
全端末に適用される、グローバルな設定 ( Global Preference ) も使用できますが、設定できる値は、`default`、 `landscape`、 `portrait` のみです。`all` は、グローバルな設定には使用できません。
{% endhint %}

&#x20;   2\. プラットフォーム毎の設定方法

```markup
<widget>
...
<platform name="ios">
 <preference name="orientation" value="default"/>
</platform>
...
</widget>
```

{% hint style="info" %}
`default` を設定した場合、Android と Windows ではすべてのオリエンテーションが使用でき、iOS では `portrait` のみ適用されます。
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ja.docs.monaca.io/reference/config/ios/config_xml.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.