Cordova plugin.xml의 내용에 대해

Cordova 작성시 문헌이 없어서 곤란해 조사한 메모

회사의 프로젝트에서 Cordova의 플러그인을 "사용"하는 것이 아니라 "만드는"필요가 나오고, 여러가지 조사를 했습니다만, 최종적으로는 TryAndError로 해결한 결과를 모으고 있습니다.

기본적으로 안드로이드 환경에서만 평가하고 있지만, 뜻은 아이폰도 윈도우도 변하지 않는다고 생각하기 때문에 같은 방식으로 진행될 것입니다. (무보증)

Cordova 구성

Cordova에서 Plugin을 사용할 때의 기본 구성은 아래 그림과 같습니다.

지금은 확실한 이야기입니다만, Cordova를 사용한 구성으로, Native인 자원을 사용한 처리가 하고 싶은 경우 등, 이런 일을 하지 않으면 안됩니다.
문제는 Plugin으로 만든 것을 배치하는 명령 "cordova plugin add (Plugin 명칭)"의 정의 파일인 "plugin.xml"입니다.

그렇다면 실제 XML이지만 다음과 같은 느낌입니다.

plugin.xml

<?xml version='1.0' encoding='utf-8'?>
<plugin id="cordova-plugin-nyanko" version="0.1.0" xmlns="http://apache.org/cordova/ns/plugins/1.0" xmlns:android="http://schemas.android.com/apk/res/android">
    <name>cordova-plugin-helloworld</name>
    <js-module name="nyanko-js" src="www/nyanko.js">
        <clobbers target="nyanko" />
    </js-module>
  <platform name="android">
    <config-file target="res/xml/config.xml" parent="/*">
      <feature name="nyanko-java">
        <param name="android-package" value="ko.nyan.nyanko.Nyanko"/>
      </feature>
    </config-file>
    <source-file src="src/Nyanko.java" target-dir="src/ko.nyan/nyanko/"/>
  </platform>
</plugin>

직감으로 알 수 있는 곳과 모르는 곳이 있습니다.

xmlns,xmlins:android

내 안에서는 오마지나이입니다.

다른 d

가장 중요한 것일지도. Cordova 내부에서는이 키를 바탕으로 관리하는 것 같습니다.

버전

자기 관리용입니다. 제어는 걸리지 않습니다.

이름

사람에게 중요한 항목. cordova plugin ls 명령으로 설명적으로 표시됩니다.

description

세세한 설명입니다. 이건 어딘가에서 보는 곳 있을까-. 나는 본 적이 없다. . .

js-module

src

IF의 Java를 어디에 저장할지입니다.
src측이 스스로 만든 플러그인의 두는 장소(로컬의 파일이라든가, Git에 있어서 르면 Git의 패스라든지)로부터의 상대 패스입니다.

이름

코코에 붙인 이름이 Cordova 내부에서의 식별용의 기호로서 define됩니다.

clobbers

설정한 값으로 js의 Window 객체의 자식 요소로서 액세스 할 수 있게 됩니다. 예를 들면, 상기의 예로, 가면, windows.nyanko라든지로 액세스를 할 수 있게 된다고 하는 것이군요.
반대로, JavaScript에서 Window 객체의 예약어를 설정하면 괜찮습니다. 그건 그렇고, 나는 위치 정보 관련 플러그인을 만들었을 때 location이라는 이름으로 아픈 눈을 떴다.

플랫폼 이름

타겟 단말군요. 이번에는 안드로이드뿐입니다.

config-file

Android의 config.xml에 이번에 추가할 config.xml에 추가하기 위한 선언입니다.
이번에 추가하는 Java 측의 클래스 정보를 기재하면 좋을 것입니다.

source-file

실제 Java 파일을 어디에서 어디로 복사할까요?
js-module과 사고 방식은 함께 있습니다.
src 파일을 dst에 복사합니다.
src의 디렉토리는, 최종적인 전개처와 같이 패키지명의 설정으로 하는 것도 있는 것 같습니다만, 개인적으로는 짧은 쪽이 틀림도 없기 때문에 기호입니다.
그래서 각 연계는 이런 느낌이 듭니다.