# Cordova

{% hint style="info" %}
Cordova 8.1.2 기반
{% endhint %}

###  플러그인 다운로드

{% content-ref url="sdk-down" %}
[sdk-down](https://developers.fingerpush.com/app-push/sdk-manual/sdk-down)
{% endcontent-ref %}

## Android

{% hint style="danger" %} <mark style="color:red;">플러그인 1.1.0 이전 버전을 사용 중 업데이트하는 경우, 반드시 변경된 사항을 반영하신 뒤 테스트 부탁드립니다.</mark>
{% endhint %}

### 플러그인 설치

1\) 핑거푸시 플러그인을 프로젝트 폴더와 같은 위치에 압축 해제합니다.

2\) 플러그인 내부의 'plugin.xml'을 찾아 'IntentService.java' 의 'target-dir' 패키지명을 사용자 프로젝트 패키지명으로 변경합니다.

```xml
<source-file src="src/android/IntentService.java" target-dir="$PACKAGE_NAME" />
```

3\) 플러그인 내부의 'IntentService.java' 의 패키지명을 사용자 프로젝트 패키지명으로 변경합니다.

4\) 'cordova plugin add ../FingerPushPlugin' 명령어를 실행하여 플러그인을 설치합니다.

{% hint style="danger" %}
&#x20;<mark style="color:red;">플러그인 설치 시 경로는 상대 경로를 사용해야 합니다.</mark>
{% endhint %}

### 프로젝트 설정하기

1\) 핑거푸시 앱 생성 및 FCM 프로젝트 생성은 Android 매뉴얼을 참고바랍니다.

{% content-ref url="android" %}
[android](https://developers.fingerpush.com/app-push/sdk-manual/android)
{% endcontent-ref %}

### 예제 파일 적용 및 푸시 메시지 확인

1\) 플러그인 내부의 'example' 폴더를 코르도바 프로젝트의 'www' 폴더로 복사 및 붙여넣기 합니다.

![](https://1606198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff5XCUiUhwc0T57hW21TH%2Fuploads%2Fr8rxHLSabdwNkLcYOfMX%2Ffp_plugin_008.png?alt=media\&token=35b2932d-a61f-4b29-a371-1167c748cafa)

2\) setDevice 함수를 통해 앱을 핑거푸시 서버에 등록합니다.

![](https://1606198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff5XCUiUhwc0T57hW21TH%2Fuploads%2FgCIg54Ztgkjx5wfr59mD%2Ffp_plugin_009-576x1024.png?alt=media\&token=b289a215-4501-4fff-b6cb-4dbe88b55a04)

3\) 디바이스가 정상적으로 등록됐다면 핑거푸시 사이트에서 확인 가능하고, 푸시 메시지를 수신할 수 있습니다.

<figure><img src="https://1606198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff5XCUiUhwc0T57hW21TH%2Fuploads%2FpxhZEY2jXJsxkunW4BJN%2F%EA%B7%B8%EB%A6%BC42.png?alt=media&#x26;token=ce449dbe-4631-41ae-8eb7-c16ed3b162bb" alt=""><figcaption></figcaption></figure>

### Android API Reference

핑거푸시 API의 기능과 변수, 결과값에 대한 정보는 아래 링크에서 확인할 수 있습니다.

{% content-ref url="../api-reference/android" %}
[android](https://developers.fingerpush.com/app-push/api-reference/android)
{% endcontent-ref %}

## iOS

### 플러그인 설치

1\) 코르도바 핑거푸시 플러그인을 코르도바 프로젝트 폴더와 같은 위치에 압축을 풉니다.

2\) 'cordova plugin add ../FingerPushPlugin' 를 호출하여 설치합니다.&#x20;

{% hint style="danger" %} <mark style="color:red;">압축이 해제된 FingerPushPlugin 폴더를 상대 경로로 접근하여 설치해야 합니다.</mark>
{% endhint %}

![](https://1606198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff5XCUiUhwc0T57hW21TH%2Fuploads%2FkhHjPjGsbQg1DdSep7Mn%2Fcordova_for_ios_01-1024x368.png?alt=media\&token=1f580c56-1451-4a43-b36c-5f4a1cadb1da)

3\) 예제를 위한 example 폴더의 example\_ios.html, example\_os.css, example\_ios.js, FingerPushPluginiOS.js, jquery\_1.5.2.js 파일을 복사 및 붙여쓰기 합니다.

![](https://1606198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff5XCUiUhwc0T57hW21TH%2Fuploads%2F9MUARroZiQU03DUus4Z1%2Fcordova_for_ios_02.png?alt=media\&token=00debd68-5304-4568-82c7-c988879dfb6e)

4\) example\_ios.js 에서 핑거푸시 사이트에서 발급 받은 AppKey와 AppScrete으로 변경합니다.

![](https://1606198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff5XCUiUhwc0T57hW21TH%2Fuploads%2FJANXjUnYzkYA2CEBaCz5%2Fcordova_for_ios_04-1024x595.png?alt=media\&token=b4bc69f9-b068-4f33-9a25-09c35b6fb14f)

5\) config.xml에서 content src="example\_ios.html" 로 변경합니다.

![](https://1606198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff5XCUiUhwc0T57hW21TH%2Fuploads%2F30bKSy7jCJJJjUo0mo5d%2Fcordova_for_ios_03-1024x595.png?alt=media\&token=9a1a963a-aa3f-4476-bcf9-281be8e55056)

### 푸시 메시지 확인

1\) 'cordova run ios' 를 호출하여 기기에 앱을 설치합니다.

![](https://1606198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff5XCUiUhwc0T57hW21TH%2Fuploads%2FUMuurjgKtxUWTFAcdyiQ%2Fcordova_for_ios_05.png?alt=media\&token=e64f2e3f-15fd-41c1-8c44-227ac823ec3a)

2\) 디바이스가 성공적으로 등록됐다면 핑거푸시 사이트에서 확인 가능합니다. 디바이스가 등록되면 디바이스 부분의 값이 증가합니다.&#x20;

{% hint style="info" %}
setRegisterDevice을 통해서도 확인 가능합니다.
{% endhint %}

<figure><img src="https://1606198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff5XCUiUhwc0T57hW21TH%2Fuploads%2FpxhZEY2jXJsxkunW4BJN%2F%EA%B7%B8%EB%A6%BC42.png?alt=media&#x26;token=ce449dbe-4631-41ae-8eb7-c16ed3b162bb" alt=""><figcaption></figcaption></figure>

3\) 디바이스가 등록된 것을 확인 후, 발송 화면에서 푸시 메시지를 보내세요.

<figure><img src="https://1606198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff5XCUiUhwc0T57hW21TH%2Fuploads%2Fi4zSvytYcIRYDZdxoFGn%2F%EA%B7%B8%EB%A6%BC31.png?alt=media&#x26;token=f4237545-26ba-4672-a596-653fb7b80b51" alt=""><figcaption></figcaption></figure>

4\) 앱에서 발송된 메세지를 확인하 수 있습니다.

![](https://1606198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff5XCUiUhwc0T57hW21TH%2Fuploads%2FW9AFksZmnsCI6eXcaOZJ%2Fcordova_for_ios_06.png?alt=media\&token=aa0c9c3c-c47e-45a2-a2b7-ea049d2cb4c8)

### iOS API Reference

{% hint style="info" %}
추가로 제공된 FingerPushPluginiOS.js를 통해 핑거푸시에서 제공하는 API 기능을 사용해 주십시오.
{% endhint %}

{% content-ref url="../api-reference/ios" %}
[ios](https://developers.fingerpush.com/app-push/api-reference/ios)
{% endcontent-ref %}