Config.xml 파일

응용 프로그램의 행동의 여러 측면 전역 구성 파일을 제어할 수 있습니다 config.xml , 즉 응용 프로그램의 홈 페이지와 함께 최상위 웹 자산 디렉터리에 배치 합니다. 이 플랫폼-불가 지론 XML 파일 W3C의 웹 응용 프로그램 (위젯) 포장 사양에 따라 포맷 이며 핵심 코르도바 API 기능, 플러그인, 및 플랫폼 관련 설정을 지정 하려면 확장.

코르 도우 바 CLI (명령줄 인터페이스에 설명)를 사용 하 여 만든 프로젝트에 대 한이 파일은 최상위 수준에서 찾을 수 있습니다 www 디렉터리. 내에서 다양 한 하위 디렉터리에이 파일의 버전을 재생성 프로젝트를 CLI를 사용 하 여 platforms . CLI를 사용 하 여 프로젝트를 생성 하지만 워크플로 SDK에 이동 플랫폼 특정 파일 원본으로 사용 됩니다.

이 섹션에는 글로벌 및 크로스 플랫폼 구성 옵션 자세히 설명합니다. 플랫폼 특정 옵션에 대 한 다음 섹션을 참조 하십시오.

다양 한 구성 옵션 아래에 선발 외에 각 대상 플랫폼에 대 한 이미지는 응용 프로그램의 핵심 집합을 구성할 수 있습니다. 자세한 내용은 아이콘 및 시작 화면을 참조 하십시오.

핵심 구성 요소

이 예제는 기본 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="*" />
        <preference name="Fullscreen" value="true" />
        <preference name="WebViewBounce" value="true" />
    </widget>

다음 구성 요소는 최상위에 표시 config.xml 파일 및 모든 지원된 코르도바 플랫폼에서 지원 됩니다:

  • <widget>요소의 id 특성은 응용 프로그램의 리버스-도메인 식별자를 제공 합니다 그리고 version 메이저/마이너/패치 표기법 그것의 전체 버전 번호.

  • <name>요소 및 애플 리 케이 션 스토어 인터페이스 내에서 디바이스의 홈 화면에 나타나는 응용 프로그램의 정식 이름을 지정 합니다.

  • <description>및 <author> 요소 메타 데이터 및 응용 프로그램 저장소 목록에서 나타날 수 있는 연락처 정보를 지정 합니다.

  • 옵션 <content> 요소는 최상위 웹 자산 디렉터리에서 응용 프로그램의 시작 페이지를 정의 합니다. 기본값은 index.html , 최상위의 관례는 프로젝트에 나타나는 www 디렉터리.

  • <access>요소는 app와 통신 하도록 허용 하는 외부 도메인 집합을 정의 합니다. 기본 값 위에 표시 된 모든 서버에 액세스할 수 있습니다. 자세한 내용은 도메인 화이트 리스트 가이드를 참조 하십시오.

  • <preference>태그의 쌍으로 다양 한 옵션을 설정 합니다. name / value 특성. 각 기본 설정 name 은 대/소문자 구분. 이 페이지의 상단에 나열 된 많은 특혜는 특정 플랫폼에 고유한. 다음 섹션에서는 세부 둘 이상의 플랫폼에 적용 되는 환경 설정.

전체 환경 설정

모든 플랫폼에 적용 되는 다음과 같은 글로벌 환경 설정.

  • Fullscreen화면 상단의 상태 표시줄을 숨길 수 있습니다. 기본값은 false . 예를 들어:

    <preference name="Fullscreen" value="true" />

  • Orientation잠금 방향 및 회전 방향에서 변화에 대응에서 인터페이스를 방지 수 있습니다. 가능한 값은 default , landscape , 또는 portrait . 예를 들어:

    <preference name="Orientation" value="landscape" />

    참고: default값은 모두 가로 및 세로 방향 사용 됩니다. 각 플랫폼의 기본 설정 (일반적으로 세로 전용)를 사용 하려는 경우이 태그를 두고는 config.xml 파일. 또한, 블랙베리를 사용 하 여 auto 대신 default 에 config.xml 파일. 지정 하면 default 는 글로벌 config.xml , 변환 auto 블랙베리 빌드에서.

멀티 플랫폼 환경 설정

다음과 같은 기본 설정 하나 이상의 플랫폼, 하지만 그들 모두 적용 됩니다.

  • DisallowOverscroll(boolean, 기본값은 false ): 설정 true 인터페이스를 사용자가 시작 또는 끝 콘텐츠의 과거 스크롤할 때 어떤 피드백을 표시 하지 않으려면 경우.

    <preference name="DisallowOverscroll" value="true"/>

    안 드 로이드와 iOS에 적용 됩니다. IOS에서, overscroll 제스처 원인 콘텐츠를 원래 위치로 다시 반송. 안 드 로이드, 그들은 콘텐츠 위쪽 또는 아래쪽 가장자리를 따라 더 미묘한 빛나는 효과 생산.

  • BackgroundColor: 응용 프로그램의 배경 색을 설정 합니다. 다음 세 가지 바이트에 대 한 알파 채널을 대표 하는 첫 번째 바이트와 4 바이트 16 진수 값 및 표준 RGB 값을 지원 합니다. 이 예제에서는 파란색을 지정합니다.

    <preference name="BackgroundColor" value="0xff0000ff"/>

    안 드 로이드와 블랙베리에 적용 됩니다. 예를 들어 모든 플랫폼에서 그렇지 않으면 사용할 수 있는 CSS 재정의:body{background-color:blue}.

  • HideKeyboardFormAccessoryBar(boolean, 기본값은 false ): 설정 true 도움, 키보드 위에 표시 되는 추가 도구 모음을 숨기려면 사용자가 다른 하나의 양식 입력에서 탐색.

    <preference name="HideKeyboardFormAccessoryBar" value="true"/>

    IOS와 블랙베리에 적용 됩니다.

    참고: 블랙베리에 대 한 유효한 값은 enable 또는disable.

<feature>요소

CLI를 사용 하 여 응용 프로그램을 구축할 경우 사용 된 plugin 장치 Api를 사용 하려면 명령. 이 최상위 수정 하지 않습니다 config.xml 파일, 그래서 <feature> 요소 작업 흐름에 적용 되지 않습니다. 경우 SDK에서 직접 사용 하는 플랫폼 관련 config.xml 파일 원본으로 사용 된 <feature> 장치 수준 Api와 외부 플러그인을 사용 하려면 태그. 그들은 일반적으로이 폼에 나타납니다.

    <feature name="Plugin" value="PluginID" />

그들은 종종 특정 플랫폼에에서 사용자 지정 값으로 나타납니다 config.xml 파일. 예를 들어, 여기에 안 드 로이드 프로젝트에 대 한 장치 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 참조를 참조 하십시오. 플러그인에 대 한 자세한 내용은 플러그인 개발 가이드를 참조 하십시오.