앱 개발 환경 설정

넥사크로플랫폼 안드로이드 앱은 이클립스, 안드로이드 SDK를 이용해 개발하며 기본적인 절차는 일반적인 안드로이드 앱을 만드는 방법과 같습니다.

이클립스와 안드로이드 SDK 설치파일과 관련된 자료는 구글 안드로이드 웹페이지를 참고하세요.

이클립스 및 안드로이드 SDK는 최신 버전 갱신 주기가 빠르므로 위 웹페이지의 링크를 이용해서 최신 개발환경으로 설치해야 합니다. 설치와 관련된 세부적인 내용은 이클립스, ADT 플러그인, 안드로이드 SDK 버전이 업데이트 될 때마다 조금씩 변경될 수 있습니다.

안드로이드 기본 개발 환경 구성은 다음과 같은 절차로 진행합니다.

1. JDK(Java SE Development Kit) 설치

2. 이클립스 설치

3. 안드로이드 SDK 설치

4. ADT 플러그인 설치

JDK(Java SE Development Kit) 설치

안드로이드 스튜디오와 이클립스는 자바 기반으로 만들어졌기 때문에 실행하기 위해서는 JDK(Java SE Development Kit) 환경이 설정되어 있어야 합니다. JDK는 무료로 제공되고 있으며 간단하게 설치할 수 있습니다.

내려 받기

아래 사이트에서 시스템 환경에 맞는 JDK를 내려받을 수 있습니다.

설치 확인

내려받은 설치파일을 실행하면 자동으로 필요한 환경설정과 설치과정을 진행합니다. 설치가 완료되면 커멘드창에서 정상적으로 설치되었는지 확인합니다.

java -version

개발 도구 설치

안드로이드 스튜디오

안드로이드 스튜디오 설치파일은 기본적으로 SDK 도구를 포함하고 있습니다. 아래 사이트에서 환경에 맞는 설치파일을 내려받을 수 있습니다.

http://developer.android.com/sdk/index.html

이클립스

이클립스는 별도의 설치 과정 없이 파일을 내려받아 압축을 풀어주면 바로 사용할 수 있습니다.

아래 사이트에서 환경에 맞는 파일을 내려받을 수 있습니다. Eclipse Standard 버전을 받거나 개발 환경에 맞는 파일을 선택해 내려받습니다.

안드로이드 SDK 설치

안드로이드 프로젝트를 진행하기 위해서는 관련된 API를 제공하는 안드로이드 SDK를 설치해야 합니다. 해당 파일은 안드로이드 개발자 사이트에서 제공하고 있습니다.

ADT 플러그인이 설치된 이클립스를 포함한 ADT Bundle 패키지를 내려받거나 SDK 설치 파일을 따로 받을 수 있습니다. SDK 설치파일만 따로 받으려면 아래 사이트 하단 메뉴에서 'USE AN EXISTING IDE' 링크를 선택하고 'SDK Tools for Windows' 설치 파일을 내려받습니다.

설치 파일을 실행해 설치가 완료되면 SDK Manager가 실행됩니다. SDK Manager는 개발에 필요한 안드로이드 API와 관련 도구를 내려 받을 수 있는 기능을 제공합니다. 항목 중 'Tools', 'Extras' 항목을 선택하고 필요한 안드로이드 API를 선택하고 설치합니다.

SDK Manager는 필요할 때 다시 실행해 추가로 API를 설치할 수 있습니다.

ADT 플러그인 설치

이클립스를 실행하면 설치된 JDK 버전에 해당하는 JRE(Java Runtime Environment)가 설정되어 있는지 확인합니다. JRE 설정은 아래 메뉴에서 확인할 수 있습니다.

Window > Preference > Java > Installed JREs

안드로이드 프로젝트를 수행하기 위해 ADT 플러그인을 설치합니다. 아래 메뉴로 이동해서 Developer Tools을 추가합니다.

Help > Install New Software

Work with 항목 옆에 있는 'Add' 버튼을 클릭하고 다음과 같이 Repository 정보를 입력합니다.

ADT Plugin
https://dl-ssl.google.com/android/eclipse/

선택할 수 있는 항목 중 Developer Tools 항목을 선택하고 설치를 진행합니다. 설치가 완료되면 이클립스가 재시작됩니다.

이클립스 프로젝트 마이그레이션

마이그레이션 절차

이클립스 ADT 플러그인으로 개발하던 프로젝트를 안드로이드 스튜디오로 마이그레이션할 수 있습니다. 마이그레이션은 아래 순서로 진행합니다.

1. [Import project] 기능을 실행합니다.

   기존에 열어놓은 프로젝트가 없다면 빠른 시작(Quick Start) 창에서 새로운 프로젝트를 생성합니다. 아래 그림에서 [Import Project (Eclipse ADT, Gradle, etc.)]를 선택합니다. 다른 프로젝트 작업 중에 새로운 프로젝트를 생성하고자 한다면 [File > New > Import Project] 항목을 선택해 기능을 실행할 수 있습니다.

2. 가져올 프로젝트를 선택합니다.

   이클립스 workspace 폴더 아래에서 기존에 작성한 프로젝트 폴더를 선택합니다.

3. 경로와 옵션 선택 후 [Finish] 버튼을 클릭합니다.

   같은 Application 이름으로 경로를 지정합니다. 같은 이름을 가진 프로젝트가 있는 경우에는 다른 이름으로 수정할 수 있습니다.

build.gradle

마이그레이션 작업 이후 빌드가 정상적으로 처리되지 않는 경우가 있습니다. 이런 경우에는 build.gradle 설정을 일부 수정해야 합니다. 자주 오류가 나는 부분은 SDK 버전이 적절하지 않게 설정되는 때도 있고 dependencies 항목의 버전이 적절하지 않은 경우가 있습니다.

apply plugin: 'com.android.application'

android {
    compileSdkVersion 22
    buildToolsVersion "23.0.3"

    defaultConfig {
        applicationId "com.tobesoft.sampleproject"
        minSdkVersion 15
        targetSdkVersion 22
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile 'com.android.support:appcompat-v7:22.2.1'
	compile 'com.android.support:support-v4.20.0.0'
	compile 'com.google.android.gms:play-services:+'
    compile files('libs/nexacro14.jar')
}

AndroidManifest.xml

구글 플레이 서비스 관련 라이브러리 설정이 기존 이클립스 ADT 플러그인 개발 환경과 달라진 부분이 있습니다. AndroidManifest.xml 파일은 그대로 사용할 수 있지만, 오류가 있는 경우 해당 파일 내 아래 옵션을 수정해줍니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.tobesoft.sampleproject"
    android:versionCode="1"
    android:versionName="1.0" android:installLocation="auto">
...
	<meta-data android:name="com.google.android.gms.version" 
		android:value="@integer/google_play_services_version" />
    </application>
</manifest>

주의

앱 프로젝트 개발

앱 개발 환경이 설정되었다면 안드로이드 스튜디오 또는 이클립스를 실행해서 안드로이드 운영체제에서 동작하는 앱을 만들 수 있습니다. 앱 프로젝트를 진행하기 전에 넥사크로 스튜디오에서 개발된 애플리케이션에서 만들어진 아카이브 파일은 지정된 경로에 위치해야 합니다.

프로젝트 생성

안드로이드 스튜디오

기존에 열어놓은 프로젝트가 없다면 빠른 시작(Quick Start) 창에서 새로운 프로젝트를 생성합니다. 아래 그림에서 [Start a new Android Studio project]를 선택합니다.

다른 프로젝트 작업 중에 새로운 프로젝트를 생성하고자 한다면 아래 메뉴에서 생성할 수 있습니다.

File > New > New Project

Minumum SDK를 설정합니다. SDK를 변경할 때마다 항목 하단에 얼마나 많은 디바이스에 대한 호환성을 제공하는지에 대한 정보를 제공합니다.

Blank Activity를 선택한 다음 추가 정보를 입력하고 [Finish] 버튼을 클릭하면 새로운 프로젝트가 생성됩니다.

이클립스

넥사크로플랫폼으로 개발된 애플리케이션을 담을 안드로이드 프로젝트를 생성하고 기본 환경을 설정해야 합니다. 새로운 프로젝트는 아래 메뉴에서 생성할 수 있습니다.

File > New > Android Application Project

넥사크로플랫폼 라이브러리 설정

안드로이드 프로젝트에서 넥사크로플랫폼에 최적화된 환경을 만들기 위해 추가로 제공되는 넥사크로플랫폼 라이브러리 파일을 설정해주어야 합니다.

안드로이드 스튜디오

먼저 프로젝트 윈도우 상단에서 뷰 옵션을 [Project]로 변경합니다. 기본값은 [Android]입니다.

먼저 제공된 라이브러리 파일을 프로젝트 폴더에 포함된 libs 폴더에 복사합니다. nexacro14.jar 파일은 [프로젝트 > app > libs] 폴더 바로 아래에 복사하고 libnexacro14.so 파일은 [프로젝트 > app > src > main] 폴더에 아래 표를 참조해 복사합니다. 생성된 폴더 구조는 아래 그림과 같습니다.

파일을 추가할 때 아래 그림처럼 파일명과 경로를 변경할 수 있는 창이 나타납니다. 기본 설정된 값으로 [OK] 버튼을 클릭합니다.

추가된 넥사크로플랫폼 라이브러리를 프로젝트에서 참조하도록 라이브러리에 추가합니다. nexacro14.jar 파일을 선택하고 컨텍스트 메뉴에서 [Add As Library] 항목을 선택합니다.

라이브러리가 정상적으로 추가되었는지 확인하려면 [프로젝트 > app] 항목을 선택하고 컨텍스트 메뉴에서 [Open Module Settings] 항목을 선택합니다.

[Modules > app] 항목에서 상단 탭을 [Dependencies]로 변경하면 라이브러리가 추가된 것을 확인할 수 있습니다.

이클립스

먼저 제공된 라이브러리 파일을 프로젝트 폴더에 포함된 libs 폴더에 복사합니다. nexacro14.jar 파일은 libs 폴더 바로 아래에 복사하고 libnexacro14.so 파일은 armeabi-v7a 폴더를 새로 만들어 복사합니다. 생성된 폴더 구조는 아래 그림과 같습니다.

추가된 넥사크로플랫폼 라이브러리를 프로젝트에서 참조하도록 Java Build Path를 설정합니다. 아래 메뉴로 이동해서 'Add Jars' 버튼을 선택하고 libs 폴더 안에 있는 nexacro14.jar 파일을 선택합니다.

File > Properties > Java Build Path > Libraries > Add JARs

리소스 설정

앱에서 사용할 로딩 이미지, 아이콘, 메시지, 레이아웃 등을 설정하는 단계입니다. 진행하는 프로젝트에 따라 변경해 적용할 수 있습니다.

각 리소스를 설정하면 아래와 같은 폴더 구조를 가집니다.

이미지 설정

로딩 이미지, 앱 아이콘을 res 폴더 아래 drawable-mdpi 폴더에 지정합니다. 적용할 이미지 파일은 앱에서 지원하는 해상도에 따라 설정할 수 있습니다. 상세한 내용은 안드로이드 매뉴얼을 참고해주세요.

아이콘 파일은 프로젝트 생성 후 수정할 수 있습니다.

이미지 설정 | 안드로이드 스튜디오

[프로젝트 > app] 항목 선택 후 컨텍스트 메뉴에서 [New > Image Asset] 항목을 선택한 후 나타난 [Asset Studio]에서 아이콘 파일 관련 설정을 변경할 수 있습니다.

http://developer.android.com/intl/ko/tools/help/image-asset-studio.html

이미지 설정 | 이클립스

프로젝트 선택 후 컨텍스트 메뉴에서 [New > Other] 항목을 선택한 후 나타난 위자드 창에서 'android icon set'으로 검색해 [Android Icon Set] 항목을 선택합니다.

[Configure Icon Set] 항목에서 아이콘 파일 관련 설정을 변경할 수 있습니다.

메시지 설정

앱 실행시 사용할 메시지를 설정합니다. 프로젝트 생성 시 만들어지는 res 폴더 아래 values 폴더에 있는 strings.xml 파일을 아래와 같이 수정합니다.

$r_title(strings.xml)
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="app_name">Nexacro 14</string>
	<string name="action_settings">Settings</string>
    
    <!-- Clipboard -->
    <string name="copy">Copy</string>
    <string name="paste">Paste</string>
    <string name="cut">Cut</string>
    <string name="close">Close</string>
    <string name="selectall">Select All</string>
    <string name="selectword">Select Word</string>
 
    <string name="needupdate">It is need to update. \r\nAfter completing, Please restart.</string>
    <string name="loadingFail">First loading is fail. \r\nPlease restart.</string>
    <string name="updateFail">Update is fail. \r\nPlease restart.</string>
    <string name="notexist">Start file is NOT exist. \r\nPlease restart.</string>
    <string name="BeingUpdated">Being updated.</string>
    <string name="wantreplace">There is a file of the save name. Do you want to replace? </string>
    <string name="ok">OK</string>
    <string name="cancel">Cancel</string>
    <string name="move">Move</string>
    <string name="upper">Upper</string>
    <string name="filter">Filter</string>
    <string name="home">Home</string>
    <string name="nofilename">No File Name.</string>     
	<string name="checkforupdates">Check for updates.</string>   
	<string name="installforupdates">Install for updates.</string>  
	<string name="downloadingforupdates">Downloading for updates.</string>    
	<string name="force_close">Update is Completed.</string> 
	<string name="LoadingPleaseWait">Loading&#8230; \r\nPlease Wait&#8230;</string> 
	
    <!-- Accessibility widget role -->
    <string name="alert">alert</string>
    <string name="pushbutton">pushbutton</string>
    <string name="combobox">combobox</string>
    <string name="checkbutton">checkbutton</string>
    <string name="radiobutton">radiobutton</string>
    <string name="text">text</string>
    <string name="list">list</string>
    <string name="listitem">listitem</string>
    <string name="statictext"></string>
    <string name="graphic">image</string>
    <string name="spacebar">space bar</string>
    <string name="textdeleted">deleted</string>
    
    <!-- Accessibility widget statue -->
    <string name="checked">checked</string>
    <string name="unchecked">unchecked</string>
    
    <!-- Accessibility reaction -->
    <string name="click">click</string>
    
    <!-- Splash message  -->
    <string name="start_initialize">Start Initialize</string> 
    <string name="check_license">Check License</string>
    <string name="load_frameworkmodule">Load Framework Module</string>
    <string name="load_extendmodule">Load Extend Module</string>
    <string name="execute_frameworkscript">Execute Framework Script</string>
    <string name="load_application">Load Application</string>
    <string name="load_failapplication">Load Fail Application Initialize. Click And Close</string>
    
</resources>

영문 메시지 외 한국어나 일본어 등의 메시지를 추가하려면 res 폴더 아래 values-ko, values-ja 와 같은 식으로 폴더를 추가하고 strings.xml 파일을 추가합니다.

bool.xml 파일을 추가합니다.

$r_title(bool.xml)

<?xml version="1.0" encoding="UTF-8"?>
<resources>
	<bool name="is_jellybean_or_higher">false</bool>
</resources>

레이아웃 설정

앱이 단말기에서 보여지는 레이아웃을 지정합니다. 넥사크로플랫폼 애플리케이션을 감싸기 위한 용도이기 때문에 기본적인 상태로 설정합니다.

res 폴더 아래에 있는 layout 폴더에 nexacro_app.xml 파일을 새로 만들어 추가합니다.

$r_title(nexacro_app.xml)

<?xml version="1.0" encoding="utf-8"?>
<!-- nexacro_app.xml -->
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/nexacro_activity"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@android:color/transparent"
    tools:context=".deviceAPI.FileDialogActivity" >

    <com.nexacro.view.NexacroLayout
        android:id="@+id/nexacro_layout"
        android:background="@android:color/transparent"
        android:layout_width="match_parent"
        android:layout_height="match_parent" >
    </com.nexacro.view.NexacroLayout>

</FrameLayout>

빌드 환경 설정

안드로이드 프로젝트를 생성하면서 기본으로 만들어진 MainActivity.java 파일과 AndroidManifest.xml 파일을 넥사크로플랫폼 환경에 맞게 수정합니다.

MainActivity.java

프로젝트 생성 시 액티비티 이름을 지정해주는데 별도로 수정하지 않는다면 MainActivity.java 라는 이름으로 생성됩니다. src 폴더 아래 지정된 패키지 이름 아래에 있는 MainActivity.java 파일을 선택하고 아래와 같이 수정해줍니다.

아래 내용 중 굵게 표시된 setBootstrapURL 메소드에 포함된 파라미터는 넥사크로 스튜디오에서 만든 start_android.json 파일이 배치된 서버 URL을 지정하고 setProjectURL 메소드에 포함된 파라미터는 해당 경로를 '/'까지 지정해줍니다.

$r_title(MainActivity.java)

package com.tobesoft.sampleproject;

import com.nexacro.NexacroUpdatorActivity;

import android.content.Intent;
import android.os.Bundle;
import android.view.View;

public class MainActivity extends NexacroUpdatorActivity {

	public MainActivity() {
		super();
		setBootstrapURL("http://172.10.10.10:8080/nexacro/start_android.json");
		setProjectURL("http://172.10.10.10:8080/nexacro/");		
	}

	@Override 
	protected void onCreate(Bundle savedInstanceState) {
		Intent intent = getIntent();
		if(intent != null) {
			String bootstrapURL = intent.getStringExtra("bootstrapURL");
			String projectUrl = intent.getStringExtra("projectUrl");
			if(bootstrapURL != null) {
				setBootstrapURL(bootstrapURL);
				setProjectURL(projectUrl);
			} 
		}
		
		super.onCreate(savedInstanceState);		
	}
	
	@Override
	public void setContentView(View view) {
		super.setContentView(view);
	}
}

super();
setBootstrapURL("http://172.10.10.10:8080/nexacro/start_android.json");
setStartupURL("http://172.10.10.10:8080/nexacro/HBDeviceTest/HBDeviceTest.xadl.js");

AndroidManifest.xml

AndroidManifest.xml 파일은 프로젝트 루트에 위치하며 애플리케이션에 대한 기본적인 정보와 특정 기능 실행 시 필요한 정보를 담고 있습니다. 기본적으로 필요한 정보를 아래 코드를 참고해 작성합니다. 아래 내용 중 굵게 표시된 package, MainActivity 에 대한 정보는 프로젝트 설정에 따라 지정해주어야 합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
	package="com.tobesoft.sampleproject"
	android:installLocation="auto"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk
        android:minSdkVersion="9"
        android:targetSdkVersion="19" />

    <uses-feature
        android:glEsVersion="0x00020000"
        android:required="true" />
   
<!-- asset/archive 기능을 사용한다면 삭제할 수 있습니다. 그렇지 않은 경우에는 삭제할 수 없습니다. -->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
  
    <application
        android:allowBackup="true"
        android:hasCode="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >

        <activity
            android:name="com.tobesoft.sampleproject.MainActivity"
            android:configChanges="orientation|keyboardHidden|screenSize"
            android:theme="@android:style/Theme.NoTitleBar" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <activity
            android:name="com.nexacro.NexacroActivity"
            android:alwaysRetainTaskState="true"
            android:configChanges="orientation|keyboardHidden|screenSize"
            android:launchMode="singleTop"
            android:theme="@android:style/Theme.NoTitleBar"
            android:windowSoftInputMode="adjustResize" >
        </activity>
     
        <meta-data
            android:name="com.google.android.gms.version"
            android:value="google_play_services_version" />
    </application>
</manifest>

배포할 앱의 기능에 따라 필요한 권한 및 기타 정보를 추가로 지정합니다. 예를 들어 카메라 기능을 사용한다면 아래와 같은 항목이 추가되어야 합니다.

...
<uses-permission android:name="android.permission.CAMERA" />
<activity android:name="com.nexacro.deviceAPI.CameraListener"
	android:screenOrientation="landscape">
	<intent-filter>
   		<category android:name="android.intent.category.LAUNCHER" />
	</intent-filter>
</activity>
<uses-feature android:name="android.hardware.camera" android:required="false"/>
<uses-feature android:name="android.hardware.camera.autofocus"
	android:required="false"/>
...

기능에 따른 정보 설정 시 추가할 수 있는 항목은 아래와 같습니다. 필요한 항목만 복사해 AndroidManifest.xml 파일에 추가합니다.

DeviceAPI

<!-- AudioPlayer, AudioRecorder -->
<uses-permission android:name="android.permission.RECORD_AUDIO" /> 
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

<!-- Camera -->
<uses-permission android:name="android.permission.CAMERA" /> 
<activity android:name="com.nexacro.deviceAPI.CameraListener" android:screenOrientation="landscape">
	<intent-filter>
    	<category android:name="android.intent.category.LAUNCHER" />
	</intent-filter>
</activity>
<uses-feature android:name="android.hardware.camera" android:required="false"/>
<uses-feature android:name="android.hardware.camera.autofocus" android:required="false"/>

<!-- Contact -->
<uses-permission android:name="android.permission.READ_CONTACTS" /> 
<uses-permission android:name="android.permission.WRITE_CONTACTS" />    

<!-- ExternalAPI -->
<uses-permission android:name="android.permission.GET_TASKS" />

<!-- Geolocation, Map -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> 
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> 
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" /> 

<!-- Map -->
<uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES"/>
<uses-library android:name="com.google.android.maps" /> 
<meta-data android:name="com.google.android.maps.v2.API_KEY" android:value="user value" />

<!-- SMS -->
<uses-permission android:name="android.permission.SEND_SMS" /> 
<uses-permission android:name="android.permission.RECEIVE_SMS" /> 
<uses-permission android:name="android.permission.READ_SMS" /> 
<uses-permission android:name="android.permission.WRITE_SMS" />

<receiver android:name="com.nexacro.deviceAPI.SmsRecv">
	<intent-filter>
		<action android:name="android.provider.Telephony.SMS_RECEIVED" />
	</intent-filter>
	<intent-filter>
		<action android:name="android.provider.Telephony.WAP_PUSH_RECEIVED" />
		<data android:mimeType="application/vnd.wap.mms-message" />
	</intent-filter>
</receiver>"

<!-- Vibrator -->
<uses-permission android:name="android.permission.VIBRATE" />

<!-- FileDialog -->
<activity android:name="com.nexacro.deviceAPI.FileDialogActivity" android:screenOrientation="sensor">
	<intent-filter>
		<category android:name="android.intent.category.LAUNCHER" />
	</intent-filter>
</activity>

GlobalAPI

<!-- 계정 -->
<uses-permission android:name="android.permission.GET_ACCOUNTS" />

<!-- 전화번호 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

<!-- 전화 걸기 -->
<uses-permission android:name="android.permission.CALL_PHONE" /> 

<!-- 디바이스 이름 -->
<uses-permission android:name="android.permission.BLUETOOTH"/>

asset/archive 기능

<uses-permission android:name="android.permission.INTERNET" /> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

cache 기능

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_INTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_INTERNAL_STORAGE" />

Notification 기능 (14.0.1.3000 이후 버전)

14.0.1.3000 이후 버전에서는 Firebase Cloud Messaging(FCM) 서비스를 사용합니다.

<!-- Adding NexacroNotificationService -->
<service android:name="com.nexacro.notification.NexacroNotificationService">
	<intent-filter>
		<action android:name="com.google.firebase.MESSAGING_EVENT" />
	</intent-filter>
</service>

<!-- Adding NexacroActivity intent-filter -->
<activity android:name="com.nexacro.NexacroActivity"
	android:launchMode="singleTask"
	android:noHistory="false"
	android:hardwareAccelerated="true"
	android:windowSoftInputMode="adjustResize"
	android:configChanges="orientation|keyboard|keyboardHidden|screenSize|navigation|uiMode">
	<intent-filter>
		<action android:name="OPEN_NEXACRO_ACTIVITY_EXAMPLE" />
		<category android:name="android.intent.category.DEFAULT" />
	</intent-filter>
</activity>

FCM 서비스를 이용하는 경우에는 build.gradle 설정에 아래 항목을 추가해주어야 합니다. 안드로이드 스튜디오에서 자동으로 설정되지 않는다면 확인 후 추가해주고 Firebase 콘솔에서 생성한 "google-services.json" 파일을 모듈 경로에 복사합니다.

buildscript {
	// Adding repositories 
	repositories {
		google()  
		jcenter()
	}
	dependencies {
		classpath 'com.android.tools.build:gradle:3.2.1'
		// NOTE: Do not place your application dependencies here; they belong
		// in the individual module build.gradle files
		// Adding google service
		classpath 'com.google.gms:google-services:4.0.1'
	}
}

allprojects {
	// Adding repositories 
	repositories {
		google()
		jcenter()
	}
}

task clean(type: Delete) {
	delete rootProject.buildDir
}

dependencies {
	implementation fileTree(include: ['*.jar'], dir: 'libs')
	implementation 'com.android.support:appcompat-v7:27.1.1'
	implementation 'com.android.support:support-v4:27.1.1'
	implementation 'com.google.android.gms:play-services-maps:16.0.0'
	implementation 'com.google.android.gms:play-services-location:16.0.0'
	implementation 'com.google.firebase:firebase-core:16.0.6'
	implementation 'com.google.firebase:firebase-messaging:17.3.4'
	implementation files('libs/nexacro14.jar')
}
apply plugin: 'com.google.gms.google-services'

Notification 기능 (14.0.1.2802 이전 버전)

14.0.1.2802 이전 버전에서는 아래와 같이 사용합니다.

<!-- Notification -->
<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />
<receiver
	android:name="com.nexacro.notification.NexacroNotificationReceiver"
	android:permission="com.google.android.c2dm.permission.SEND" >
	<intent-filter>
		<action android:name="com.google.android.c2dm.intent.RECEIVE" />
		<category android:name="com.nexacro" />
	</intent-filter>
	<intent-filter>
		<action android:name="com.google.android.c2dm.intent.REGISTRATION" />
		<category android:name="com.nexacro" />
	</intent-filter> 
</receiver>
<service android:name="com.nexacro.notification.NexacroNotificationService" />

빌드

앱 테스트

1. 안드로이드 단말기를 PC에 USB로 연결해 바로 테스트할 수 있습니다. 단말기를 직접 연결하는 경우에는 단말기에 애플리케이션 개발 옵션인 [애플리케이션 > 개발 > USB 디버깅] 항목을 설정하고 단말기에 맞는 드라이버를 설치해주어야 합니다.

2. 안드로이드 스튜디오 또는 이클립스에서 Run 메뉴를 수행합니다. Run 메뉴는 APK를 생성 및 단말기에 설치하고 실행까지 할 수 있는 기능입니다. 실행하기 전에 어느 단말기에서 실행할지 선택합니다.

Run > Run

안드로이드 스튜디오

이클립스

설치 파일 생성

완성된 앱을 배포하기 위해서는 앱을 인식할 수 있는 keystore를 생성하고 서명된 APK 파일을 생성해야 합니다. keystore 파일은 최초 1회 생성하며 이후 앱이 업데이트되었을때는 최초 생성된 keystore 파일을 사용합니다.

keystore 생성 및 Signed APK 를 생성하는 방법은 구글의 웹페이지를 참조하십시오.

안드로이드 스튜디오

상단 메뉴에서 [Build > Generate Singed APK] 항목을 선택합니다.

이클립스

프로젝트를 선택하고 컨텍스트 메뉴에서 [Android Tools > Export Signed Application Package] 항목을 선택합니다.