막대그래프와 함께 자주 사용되는 그래프의 형태로는 아마도 원 그래프가 아닐까 합니다. 이번 포스팅에서는 앞에서 소개했던 achartengine 라이브러리를 사용하여 원 그래프를 표시해 보도록 하겠습니다.

상황설정

2011년도 분기별 판매 비율이라는 가정으로 다음의 표를 그래프로 표시해 봤습니다.
당연한 이야기이겠지만, 그래프에 나타나는 각 항목의 총 합이 100%가 되어야 하겠지요.

1/4분기	2/4분기	3/4분기	4/4분기
20%	30%	40%	10%

위의 표를 그래프로 표시한 실행 결과는 아래와 같습니다.

프로젝트의 생성 및 그래프 라이브러의 참조 추가

ChartEx라는 프로젝트를 kr.pe.hoyanet.chartex라는 패키지명으로 생성하고, 프로젝트 생성시 default로 나타나는 main.xml의 기본 TextView를 삭제한 후에 최 상위 LinearLayout에게 llBody라는 아이디를 부여했습니다. 이 과정은 앞에서 진행했던 기본 막대그래프 표시 예제와 동일하게 진행했습니다. achartengine을 사용하여 그래프를 표시하는 기본적인 방법은 다음의 포스팅을 참조하시기 바랍니다.

[Android Lib] 막대그래프 그리기 (1)

원 그래프를 위한 처리 단계

먼저 그래프를 그리기 위한 그래프 렌더러 객체를 생성합니다.

// 그래프 렌더러 생성
DefaultRenderer renderer = new DefaultRenderer();

상단 표시 제목과 글자 크기를 설정합니다.

// 상단 표시 제목과 글자 크기
renderer.setChartTitle("2011 분기별 판매비율");
renderer.setChartTitleTextSize(35);

위에서 표로 정의했던 각 항목에 대한 데이터를 선언합니다.

// 각 항목에 대한 데이터
double[] values = new double[] { 20, 40, 30, 10 };

각 항목별 이름을 지정합니다.

// 각 항목별 문구 지정
CategorySeries series = new CategorySeries("분기별 실적");
series.add("1/4분기", values[0]);
series.add("2/4분기", values[1]);
series.add("3/4분기", values[2]);
series.add("4/4분기", values[3]);

실행화면을 보면 그래프의 근처에 함께 표시되는 회색 작은 글자가 있습니다. 항목별 이름을 표시하는 것입니다.
그래프와 함께 표시되는 항목별 표시 문구의 글자 크기를 지정합니다.

// 그래프와 함께 표시되는 항목별 표시 문구의 글자 크기
renderer.setLabelsTextSize(15);

하단부에 표시되는 항목별 이름에 대한 글자 크기를 별도로 지정합니다.

// 하단부에 표시되는 문구의 글자 크기
renderer.setLegendTextSize(25);

각 항목에 연결할 컬러 지정합니다. 그래프의 항목과 페이지 하단부의 항목이름에 적용되는 색상값 입니다.

// 각 항목에 연결할 컬러 지정
int[] colors = new int[] { Color.BLUE, Color.GREEN, Color.MAGENTA, Color.YELLOW };
for (int color : colors) {
	SimpleSeriesRenderer r = new SimpleSeriesRenderer();
	r.setColor(color);
	renderer.addSeriesRenderer(r);
}

Zoom 버튼 표시 여부와 Zoom 기능 활성화를 지정합니다.

// Zoom 버튼 표시 여부
renderer.setZoomButtonsVisible(true);
// Zoom 기능 활성화
renderer.setZoomEnabled(true);

설정한 내용을 토대로 그래프 View 형태로 얻어 LinearLayout에 추가합니다.

// 그래프를 View로 얻어온다.
GraphicalView gv = ChartFactory.getPieChartView(this, series, renderer);

// 그래프의 화면 출력
LinearLayout llBody = (LinearLayout) findViewById(R.id.llBody);
llBody.addView(gv);

이제 즐깁시다~!!!

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

앞에서 소개했던 막대그래프 샘플에서 두가지 이상 분류에 대한 표현 방법을 살펴보도록 하겠습니다.
우선 실행화면을 살펴보면 아래와 같습니다.
두개의 실행화면중에서 우선 왼쪽의 형태를 살펴보고 그런 다음 오른쪽 형태로 변경해 보겠습니다.
(파라미터 값을 한개만 변경하면 형태가 바뀝니다.)

프로젝트의 생성 및 그래프 라이브러의 참조 추가

achartengine을 사용하여 그래프를 표시하는 기본적인 방법은 다음의 포스팅을 참조하시기 바랍니다.

[Android Lib] 막대그래프 그리기 (1)

처리를 위해서 확인할 부분

처리를 위해서 확인할 부분은 두 부분 입니다. 우선 표시할 수치값들이 하나 더 늘어나야 합니다.

// 표시할 수치값
List values = new ArrayList();
// 안드로이드폰 수치값들
values.add(new double[] { 10230, 10300, 14240, 15244, 15900, 19200,
		22030, 21200, 19500, 15500, 12600, 14000 });
// 아이폰용 수치값들
values.add(new double[] { 15230, 17300, 9240, 10540, 7900, 9200, 12030,
		11200, 9500, 10500, 11600, 13500 });

그런 다음 두 종류의 수치값에 대한 분류명과 색상이 정의되어야 합니다.

// 분류에 대한 이름
String[] titles = new String[] { "안드로이드폰", "아이폰" };

// 항목을 표시하는데 사용될 색상값
int[] colors = new int[] { Color.YELLOW, Color.BLUE };

전체 소스코드

처리에 사용된 전체 소스코드는 다음과 같습니다. 앞 포스팅에서 소개한 소스에서 일부만 수정한 내용입니다.

package kr.pe.hoyanet.chartex;

import java.util.ArrayList;
import java.util.List;

import org.achartengine.ChartFactory;
import org.achartengine.GraphicalView;
import org.achartengine.chart.BarChart.Type;
import org.achartengine.model.CategorySeries;
import org.achartengine.model.XYMultipleSeriesDataset;
import org.achartengine.renderer.SimpleSeriesRenderer;
import org.achartengine.renderer.XYMultipleSeriesRenderer;

import android.app.Activity;
import android.graphics.Color;
import android.graphics.Paint.Align;
import android.os.Bundle;
import android.widget.LinearLayout;

public class CharExActivity extends Activity {

	@Override
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.main);

		// 표시할 수치값
		List<double[]> values = new ArrayList<double[]>();
		// 안드로이드폰 수치값들
		values.add(new double[] { 10230, 10300, 14240, 15244, 15900,
				19200, 22030, 21200, 19500, 15500, 12600, 14000 });
		// 아이폰용 수치값들
		values.add(new double[] { 15230, 17300, 9240, 10540, 7900,
				9200, 12030, 11200, 9500, 10500, 11600, 13500 });

		/** 그래프 출력을 위한 그래픽 속성 지정객체 */
		XYMultipleSeriesRenderer renderer = new XYMultipleSeriesRenderer();

		// 상단 표시 제목과 글자 크기
		renderer.setChartTitle("2011년도 판매량");
		renderer.setChartTitleTextSize(20);

		// 분류에 대한 이름
		String[] titles = new String[] { "안드로이드폰", "아이폰" };

		// 항목을 표시하는데 사용될 색상값
		int[] colors = new int[] { Color.YELLOW, Color.BLUE };

		// 분류명 글자 크기 및 각 색상 지정
		renderer.setLegendTextSize(15);
		int length = colors.length;
		for (int i = 0; i < length; i++) {
			SimpleSeriesRenderer r = new SimpleSeriesRenderer();
			r.setColor(colors[i]);
			renderer.addSeriesRenderer(r);
		}

		// X,Y축 항목이름과 글자 크기
		renderer.setXTitle("월");
		renderer.setYTitle("판매량");
		renderer.setAxisTitleTextSize(12);

		// 수치값 글자 크기 / X축 최소,최대값 / Y축 최소,최대값
		renderer.setLabelsTextSize(10);
		renderer.setXAxisMin(0.5);
		renderer.setXAxisMax(12.5);
		renderer.setYAxisMin(0);
		renderer.setYAxisMax(24000);

		// X,Y축 라인 색상
		renderer.setAxesColor(Color.WHITE);
		// 상단제목, X,Y축 제목, 수치값의 글자 색상
		renderer.setLabelsColor(Color.CYAN);

		// X축의 표시 간격
		renderer.setXLabels(12);
		// Y축의 표시 간격
		renderer.setYLabels(5);

		// X,Y축 정렬방향
		renderer.setXLabelsAlign(Align.LEFT);
		renderer.setYLabelsAlign(Align.LEFT);
		// X,Y축 스크롤 여부 ON/OFF
		renderer.setPanEnabled(false, false);
		// ZOOM기능 ON/OFF
		renderer.setZoomEnabled(false, false);
		// ZOOM 비율
		renderer.setZoomRate(1.0f);
		// 막대간 간격
		renderer.setBarSpacing(0.5f);

		// 설정 정보 설정
		XYMultipleSeriesDataset dataset = new XYMultipleSeriesDataset();
		for (int i = 0; i < titles.length; i++) {
			CategorySeries series = new CategorySeries(titles[i]);
			double[] v = values.get(i);
			int seriesLength = v.length;
			for (int k = 0; k < seriesLength; k++) {
				series.add(v[k]);
			}
			dataset.addSeries(series.toXYSeries());
		}

		// 그래프 객체 생성
		GraphicalView gv = ChartFactory.getBarChartView(this, dataset,
				renderer, Type.STACKED);

		// 그래프를 LinearLayout에 추가
		LinearLayout llBody = (LinearLayout) findViewById(R.id.llBody);
		llBody.addView(gv);
	}
}

이 방법의 단점은 처음 표시된 항목이 아래 깔리고 그 위에 두번째 항목을 표시하기 때문에, 두번째 항목중에서 첫번째 항목보다 큰 값이 있다면, 그 값은 두번째 항목의 값에 가려져 표시가 되지 않는다는 점 입니다. (실행화면에서 1월과 2월의 데이터를 참조하세요)

만약 이런 현상을 해결하기 위해서 두개의 항목을 병렬(실행화면 두번째)로 표현하고자 한다면 105~106라인의 막대그래프 생성부분에서 마지막 파라미터를 Type.DEFAULT로 수정합니다.

// 그래프 객체 생성
GraphicalView gv = ChartFactory.getBarChartView(this, dataset,
                      renderer, Type.DEFAULT);

이제 즐깁시다~!!

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

안드로이드에서 차트를 그리는 방법을 찾다보니 안드로이드의 기본 API로는 직접 일일이 구현을 해 주어야 한다는 결론에 도달해서 외부 라이브러리를 찾아보기 시작했습니다.

역시나 이미 만들어진 라이브러리가 존재했었고 여러 유료 라이브러리와 무료 라이브러리 중에서 관심이 간 것은 당연 무료 라이브러리 였습니다.

오늘 소개할 라이브러리는 achartengine 이라는 라이브러리 입니다. achartengine은 무료이면서도 막대그래프, 선 그래프, 원형 그래프 등 다양한 모양의 그래프를 표현할 수 있는 기능을 갖고 있습니다.
오늘은 그 중에서 가장 기본적인 막대그래프를 사용해 보려고 합니다.

라이브러리의 다운로드

http://code.google.com/p/achartengine 에서 라이브러리를 다운로드 받을 수 있습니다. 라이브러리 다운로드를 위해서 사이트에 접속하면 아래와 같은 웹 페이지가 나타납니다. 사이트에 접속한 후에 Download 메뉴를 클릭합니다.




다운로드 페이지에 다운로드 받을 수 있는 파일들의 목록이 나타납니다. 데모소스와 API문서, 그리고 라이브러리 파일등이 버전별로 나열됩니다. 확장자가 jar로 되어 있는 achartengine-0.7.0.jar 파일을 선택 했습니다.




파일을 선택하여 클릭하고 나면 실제 다운로드 페이지로 넘어갑니다. 여기서 라이브러리 파일을 다운로드 받습니다.

안드로이드 프로젝트의 생성

라이브러리를 사용해 보기 위해서 ChartEx라는 프로젝트를 생성했습니다. 프로젝트의 패키지 이름은 kr.pe.hoyanet.chartex로 생성했습니다.

안드로이드에서 새로운 프로젝트를 생성하는 과정은 다음의 포스팅을 참조하시기 바랍니다.

[Android TIP] Hello World

프로젝트를 생성한 후에 /res/layout/main.xml 파일을 열어서 기본적으로 표시되는 TextView 컨트롤을 삭제했습니다. 그리고 소스를 통해서 메인 LinearLayout에 그래프를 넣어주기 위해서 llBody 라는 id값을 부여했습니다.

프로젝트에 라이브러리 포함하기

안드로이드 프로젝트에 다운로드 받은 라이브러리를 포함시키기 위해서 화면 좌측의 Package Explorer창의 프로젝트 이름을 마우스로 우클릭하여 "New > Folder" 메뉴를 선택합니다.




새로운 폴더 추가 창이 나타나면 폴더의 이름을 "lib"라고 지정한 후에 OK를 누릅니다.




생성된 lib 폴더에 다운로드 받은 achartengine-0.7.0.jar파일을 넣습니다.




다시 프로젝트 이름을 마우스로 우클릭하여 메뉴를 열고, 맨 아래에 나타나는 Properties 항목을 선택하여 프로젝트 설정창을 표시합니다.




프로젝트 환경설정 창이 나타나면 왼쪽 트리에서 "Java Build Path"항목을 선택합니다.
그런 다음 화면 중앙에서 "Libraries"탭으로 이동하고 우측의 Add JARs... 버튼을 클릭합니다.




"JAR Selection" 창이 나타나면 앞에서 프로젝트 안으로 복사해서 넣어준 JAR파일을 선택하고 "OK"버튼을 눌러줍니다. 나머지 창들도 모두 "OK"버튼을 눌러서 닫습니다.

그래프 라이브러리 사용

그래프 라이브러리를 사용하기 위해서는 achartengine에서 제공하는 객체에 그래프 표현에 필요한 데이터, 색상, 글자크기 등을 메소드로 설정하고 View 형태의 객체를 얻어냅니다. 그런 다음 그 객체를 LinearLayout등의 컨트롤에 addView 메소드를 사용하여 포함시킵니다.

우선 간단한 샘플을 살펴보기 위해서 월별 판매량이라는 주제를 표현해 보기로 하겠습니다.
실행결과를 먼저 살펴본다면 아래 화면과 같이 나타납니다. (갤럭시S2 캡쳐화면입니다.)




각 단계별로 살펴보도록 하겠습니다. 그래프의 각 부분에서 사용되는 색상값에 차이를 두었습니다. 소스에서 표현하는 색상값과 실행결과 화면에서 표시되는 색상을 비교하시면서 보시면 이해가 빠를 것 같습니다.

아래의 소스코드는 모두 Activity클래스의 onCreate 메소드 안에서 처리했습니다.

표시에 사용될 데이터 선언

화면에 표시할 데이터를 다음과 같이 선언합니다.

// 표시할 수치값
List<double[]> values = new ArrayList<double[]>();
values.add(new double[] { 14230, 12300, 14240, 15244, 15900, 19200, 22030,
                          21200, 19500, 15500, 12600, 14000 });

그래프 출력을 위한 그래픽 속성 지정

먼저 그래프 출력을 위한 객체를 생성합니다.

/** 그래프 출력을 위한 그래픽 속성 지정객체 */
XYMultipleSeriesRenderer renderer = new XYMultipleSeriesRenderer();

상단에 표시할 제목과 글자 크기를 지정합니다. 제목이 필요하지 않은 경우 생략해도 됩니다.

// 상단 표시 제목과 글자 크기
renderer.setChartTitle("2011년도 판매량");
renderer.setChartTitleTextSize(20);

수치값을 표현하기 위한 항목이름과 색상(노란색)을 지정합니다. 맨 처음에 "월별 판매량"이라고 지정하고 어떤 항목들이 노란색으로 표시되는지 눈여겨 보시기 바랍니다.

// 분류에 대한 이름
String[] titles = new String[] { "월별 판매량" };
        
// 항목을 표시하는데 사용될 색상값
int[] colors = new int[] { Color.YELLOW };
        
// 분류명 글자 크기 및 각 색상 지정
renderer.setLegendTextSize(15);
int length = colors.length;
for (int i = 0; i < length; i++) {
    SimpleSeriesRenderer r = new SimpleSeriesRenderer();
    r.setColor(colors[i]);
    renderer.addSeriesRenderer(r);
}

X,Y축의 항목 이름과 글자 크기를 지정합니다. 아래의 소스에서 지정하고 있는 문구가 실행화면에서 어느 위치에 표시되고 있는지 눈여겨 확인하시기 바랍니다.

// X,Y축 항목이름과 글자 크기
renderer.setXTitle("월");
renderer.setYTitle("판매량");
renderer.setAxisTitleTextSize(12);

각 수치값들의 글자 크기와 X축의 최소,최대값 범위. 그리고 Y축의 최소,최대값 범위를 지정합니다.
그래프의 X축과 Y축에 깨알같이 표시되는 숫자값들에 대한 속성입니다.

// 수치값 글자 크기 / X축 최소,최대값 / Y축 최소,최대값
renderer.setLabelsTextSize(10);
renderer.setXAxisMin(0.5);
renderer.setXAxisMax(12.5);
renderer.setYAxisMin(0);
renderer.setYAxisMax(24000);

X축과 Y축의 라인색상을 정의합니다. 가로,세로 바깥 선을 회색으로 지정했습니다.

// X,Y축 라인 색상
renderer.setAxesColor(Color.WHITE);

상단 제목, X,Y축의 제목, 수치값의 글자 색상을 지정합니다. 색상값을 CYAN으로 지정했습니다. 사이언(밝은 하늘색?)으로 표시되는 항목들을 눈여겨 보시기 바랍니다.

// 상단제목, X,Y축 제목, 수치값의 글자 색상
renderer.setLabelsColor(Color.CYAN);

X축과 Y축의 표시 간격을 지정합니다. X축은 월별 데이터이기 때문에 12개를 표시하도록 지정했습니다. Y축은 값의 범위가 워낙 넓기 땜누에 5개의 항목으로 나누어서 표시하도록 지정했습니다. 값이 커질 수록 각 수치의 간격은 더욱 촘촘해 집니다.

// X,Y축 정렬방향
renderer.setXLabelsAlign(Align.LEFT);
renderer.setYLabelsAlign(Align.LEFT);

그 외의 자잘한 옵션을 지정합니다. 각 옵션의 의미는 주석을 참조하시기 바랍니다.

// X,Y축 스크롤 여부 ON/OFF
renderer.setPanEnabled(false, false);
// ZOOM기능 ON/OFF
renderer.setZoomEnabled(false, false);
// ZOOM 비율
renderer.setZoomRate(1.0f);
// 막대간 간격
renderer.setBarSpacing(0.5f);

마지막으로 지금껏 설정한 정보를 dataset 형태로 저장합니다. 이 코드는 라이브러리의 데모소스에서 그대로 가져왔습니다. 그다지 수정할 사항이 없는 듯 합니다.

// 설정 정보 설정
XYMultipleSeriesDataset dataset = new XYMultipleSeriesDataset();
for (int i = 0; i < titles.length; i++) {
	CategorySeries series = new CategorySeries(titles[i]);
	double[] v = values.get(i);
	int seriesLength = v.length;
	for (int k = 0; k < seriesLength; k++) {
		series.add(v[k]);
	}
	dataset.addSeries(series.toXYSeries());
}

그래프 View생성 및 레이아웃에 포함시키기

지금까지 설정한 정보를 토대로 하여 그래프를 View형태로 얻어옵니다. 이 View를 레이아웃에 addView 메소드를 사용하여 포함시키면 됩니다.

// 그래프 객체 생성
GraphicalView gv = ChartFactory.getBarChartView(this, dataset,
                                              renderer, Type.STACKED);

// 그래프를 LinearLayout에 추가
LinearLayout llBody = (LinearLayout) findViewById(R.id.llBody);
llBody.addView(gv);

이 단계를 모두 onCreate() 메소드 안에 기술하면 앞에서 보여드렸던 형태의 실행화면이 나타납니다.

전체 소스코드

그래프를 출력하는데 사용된 전체 소스코드는 다음과 같습니다.

package kr.pe.hoyanet.chartex;

import java.util.ArrayList;
import java.util.List;

import org.achartengine.ChartFactory;
import org.achartengine.GraphicalView;
import org.achartengine.chart.BarChart.Type;
import org.achartengine.model.CategorySeries;
import org.achartengine.model.XYMultipleSeriesDataset;
import org.achartengine.renderer.SimpleSeriesRenderer;
import org.achartengine.renderer.XYMultipleSeriesRenderer;

import android.app.Activity;
import android.graphics.Color;
import android.graphics.Paint.Align;
import android.os.Bundle;
import android.widget.LinearLayout;

public class ChartExActivity extends Activity {

	@Override
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.main);

		// 표시할 수치값
		List<double[]> values = new ArrayList<double[]>();
		values.add(new double[] { 14230, 12300, 14240, 15244, 15900, 19200,
				22030, 21200, 19500, 15500, 12600, 14000 });

		/** 그래프 출력을 위한 그래픽 속성 지정객체 */
		XYMultipleSeriesRenderer renderer = new XYMultipleSeriesRenderer();

		// 상단 표시 제목과 글자 크기
		renderer.setChartTitle("2011년도 판매량");
		renderer.setChartTitleTextSize(20);

		// 분류에 대한 이름
		String[] titles = new String[] { "월별 판매량" };

		// 항목을 표시하는데 사용될 색상값
		int[] colors = new int[] { Color.YELLOW };

		// 분류명 글자 크기 및 각 색상 지정
		renderer.setLegendTextSize(15);
		int length = colors.length;
		for (int i = 0; i < length; i++) {
			SimpleSeriesRenderer r = new SimpleSeriesRenderer();
			r.setColor(colors[i]);
			renderer.addSeriesRenderer(r);
		}

		// X,Y축 항목이름과 글자 크기
		renderer.setXTitle("월");
		renderer.setYTitle("판매량");
		renderer.setAxisTitleTextSize(12);

		// 수치값 글자 크기 / X축 최소,최대값 / Y축 최소,최대값
		renderer.setLabelsTextSize(10);
		renderer.setXAxisMin(0.5);
		renderer.setXAxisMax(12.5);
		renderer.setYAxisMin(0);
		renderer.setYAxisMax(24000);

		// X,Y축 라인 색상
		renderer.setAxesColor(Color.WHITE);
		// 상단제목, X,Y축 제목, 수치값의 글자 색상
		renderer.setLabelsColor(Color.CYAN);

		// X축의 표시 간격
		renderer.setXLabels(12);
		// Y축의 표시 간격
		renderer.setYLabels(5);

		// X,Y축 정렬방향
		renderer.setXLabelsAlign(Align.LEFT);
		renderer.setYLabelsAlign(Align.LEFT);
		// X,Y축 스크롤 여부 ON/OFF
		renderer.setPanEnabled(false, false);
		// ZOOM기능 ON/OFF
		renderer.setZoomEnabled(false, false);
		// ZOOM 비율
		renderer.setZoomRate(1.0f);
		// 막대간 간격
		renderer.setBarSpacing(0.5f);

		// 설정 정보 설정
		XYMultipleSeriesDataset dataset = new XYMultipleSeriesDataset();
		for (int i = 0; i < titles.length; i++) {
			CategorySeries series = new CategorySeries(titles[i]);
			double[] v = values.get(i);
			int seriesLength = v.length;
			for (int k = 0; k < seriesLength; k++) {
				series.add(v[k]);
			}
			dataset.addSeries(series.toXYSeries());
		}

		// 그래프 객체 생성
		GraphicalView gv = ChartFactory.getBarChartView(this, dataset,
				renderer, Type.STACKED);

		// 그래프를 LinearLayout에 추가
		LinearLayout llBody = (LinearLayout) findViewById(R.id.llBody);
		llBody.addView(gv);
	}
}

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

프로그램안에서 사용해야 할 다량의 문자열들을 정의하는데 있어서 효율적인 방법은 소스코드에 모든 내용을 포함시키기 보다는 외부에 내용을 저장해 놓고 필요할 때 마다 읽어오는 방법입니다.

안드로이드에서는 문자열로서 사용하기 위한 데이터를 보관하기 위한 기법으로 리소스 XML에 내용을 기술하는 방법과 SQLite를 사용하는 방법, 그리고 assets 디렉토리를 사용하는 방법을 제공해 주고 있습니다.

오늘 소개할 내용은 assets 디렉토리에 저장된 텍스트 파일을 프로그램내로 읽어들이는 내용입니다.

assets 디렉토리

안드로이드 프로젝트를 이클립스 상에서 보면 assets라는 (평소에는 잘 사용하지 않는) 디렉토리에 있습니다. 프로그램과 직접적으로 연관되지 않은 비 리소스 파일들을 저장해 놓고 필요한 경우 스트림을 생성하여 읽어들이기 위한 저장공간입니다.

이 폴더안에 test.txt라는 파일을 넣었다고 가정하고 이 파일의 내용을 프로그램의 Runtime시에 읽어오는 방법을 소개하겠습니다.

AssetManager의 객체 생성

Context 클래스 내에 보면 getResource()라는 메소드가 있습니다. getResource()라는 메소드는 Resources 라는 클래스의 객체를 리턴합니다. 이 객체는 App이 갖고 있는 자원에 접근할 수 있는 객체입니다. 이 객체를 통해서 AssetManager라는 객체를 얻을 수 있습니다.

Context 클래스

Resources getResource();
리소스 객체를 얻어옵니다.

만약 Activity안에서 AssetManager객체를 얻고자 한다면 다음과 같이 사용할 수 있습니다.

Resources r = getResource();

Context 클래스는 Activity 클래스의 상위 클래스이기 때문에 Activity 안에서는 Context클래스 내의 기능들을 자기것인양 사용할 수 있습니다.

리소스 객체를 얻은 후에는 이 리소스 객체를 통해서 AssetManager 객체를 얻어옵니다.

Resources클래스

AssetManager getAssets();
AssetManager 객체를 얻어옵니다.

AssetManager를 통하여 파일 열기

AssetManager 객체가 생성되면 이 객체의 open() 메소드를 사용하여 InputStream 객체를 얻을 수 있습니다. open() 메소드는 호출 시에 대상 파일의 이름을 문자열로 전달합니다. 파일이 위치한 경로는 이클립스 프로젝트 내의 assets 라는 폴더로 이미 확정이 되어 있는 상태이기 때문에 전달하는 파라미터는 파일의 이름만을 전달합니다. 주의하실 점은 이 메소드를 사용하려면 try { } ~ catch { } 블록으로 묶어 주어야 한다는 점 입니다. 그래서 Asset객체를 통해서 InputStream을 여는 과정은 다음과 같아집니다.

AssetManager am = m_context.getResources().getAssets();
InputStream is = null;

try {
	is = am.open("contact.txt");
	// 스트림을 사용합니다.
} catch (Exception e) {
	// 에러가 발생한 경우의 처리
} finally {
	if (is != null) {
		try {
			is.close();
			is = null;
		} catch (Exception e) {}
	}
}

am = null;

test.txt 파일을 읽기

Context객체와 읽어야 할 파일이름을 전달하였을 때, 해당 파일의 내용을 읽어서 문자열로 리턴해 주는 함수를 구현해 본다면 다음과 같이 구현할 수 있겠습니다.

String readAsset(Context context, String file_name) {
	AssetManager am = context.getResources().getAssets();
	InputStream is = null;
	// 읽어들인 문자열이 담길 변수
	String result = null;

	try {
		is = am.open(file_name);
		int size = is.available();

		if (size > 0) {
			byte[] data = new byte[size];
			is.read(data);
			result = new String(data);
		}
	} catch (Exception e) {
		e.printStackTrace();
	} finally {
		if (is != null) {
			try {
				is.close();
				is = null;
			} catch (Exception e) {}
		}
	}

	am = null;
	return result;
}

Activity클래스 안에서 사용방법은 다음과 같습니다.

String data = readAsset(this, "test.txt");

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

안드로이드 작업을 하다보면 레이아웃 XML파일이 아래 화면과 같이 design탭과 소스탭으로 표시되면서 레이아웃 작성화면이 보이지 않는 경우가 있습니다.

이클립스에는 원래 XML편집기가 여러개가 있는데, 간혹다가 이클립스가 Android Layout XML Editor로 열어야할 파일을 이클립스의 기본 XML 편집기로 열게 되는 경우입니다.




이 문제를 해결하려면 편집을 원하는 XML파일을 마우스 우클릭하여 Open With > Android Layout Editor를 선택하시면 됩니다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

안드로이드 에뮬레이터는 정말이지 사람 속터지게 느립니다. 한번 실행버튼을 누르면 완전히 에뮬레이터가 부팅될 때 까지 3~5분 정도는 걸리는 듯 합니다.

그렇기 때문에 강의를 진행하면서도 안드로이드 핸드폰이 있는 분들은 가급적 핸드폰을 통해서 테스트를 하시도록 권해 드리고 있습니다.

이번에는 이클립스를 통한 실행을 에뮬레이터가 아닌 실제 단말기를 통해서 진행하는 과정에 대해서 소개해 보겠습니다.

안드로이드 단말 USB드라이버 설치

우선은 (Windows 운영체제에 한해서) 각 제조사에서 배포하는 안드로이드 USB 드라이버를 설치해야 합니다. 제조사별 드라이버 파일의 다운로드는 각 제조사 사이트를 참조하시기 바랍니다.

안드로이드 단말의 환경설정

USB연결을 통한 단말 디버깅 기능을 사용하기 위해서는 핸드폰에서 몇가지 설정을 해 주어야 합니다.
우선 PC와의 USB연결을 제거합니다. 핸드폰에서 "환경설정" 메뉴로 들어갑니다. 환경설정 메뉴 하위의 "응용프로그램"메뉴를 선택합니다.





응용 프로그램 페이지에 들어가면 우선 "알 수 없는 소스"항목에 대해서 체크가 되어 있어야 합니다.
안드로이드 폰은 구글 마켓을 통해서 다운로드 받는 프로그램을 제외한 모든 프로그램들을 "알 수 없는 소스"라고 인식합니다. (T-Store나 alleh Store등 역시 알 수 없는 소스 입니다.)
이클립스를 통해서 실행하는 프로그램이 "알 수 없는 소스"인 것은 두말할 필요가 없겠지요.

그 다음 맨 아래 있는 "개발"항목을 선택합니다.





페이지가 이동되면 "개발"페이지에 있는 체크박스들을 모두 체크합니다.
제조사에 따라서 "USB연결시 단말 화면이 꺼지지 않음"이라는 세가지 항목이 나타나는 경우가 있습니다.
아래 보이는 화면인 삼성 갤럭시S2의 화면입니다.

설정이 완료되면 화면을 빠져 나온 후에 USB를 통해서 PC와 연결합니다.
PC와 연결시 주의하실 점은 핸드폰에서 "USB저장소로 사용"이 활성화 되어 있으면 안된다는 것입니다.

이클립스에서의 실행

핸드폰이 연결된 후에 이클립스에서 RUN버튼을 누르면 다음과 같은 화면이 나타납니다.
에뮬레이터만 생성되어 있을 경우에는 구동중인 에뮬레이터가 보였지만, 핸드폰이 연결되면 연결된 핸드폰의 Serical Number가 함께 표시됩니다. 저 항목을 선택하고 "OK"버튼을 누르면 안드로이드 단말을 통해서 결과를 확인할 수 있습니다.



앞에서 진행했던 Hello World 예제를 단말기에서 실행한 모습입니다.





단말에서 실행한 후에 프로그램 목록을 살펴보면 조금전에 테스트한 항목이 설치되어 있는 것을 확인할 수 있습니다.

Run버튼 클릭시 Device Chooser 화면이 나타나지 않는 경우

간혹가다가 (사실은 꽤 자주) Run버튼을 클릭하였더니 아래와 같은 화면이 나타나지 않고 (단말기가 연결되어 있음에도 불구하고) 즉시 에뮬레이터가 구동되는 경우가 있습니다.



이 경우에는 이클립스의 설정이 유실되어서 그렇습니다.
이클립스 상에서 "Run > Run Configurations"메뉴를 선택합니다.
좌측의 메뉴 트리에서 "Android > 프로젝트이름"항목을 선택한 후에 화면 중앙에서 "Target"탭으로 이동합니다.



Target탭으로 이동하면 라디오 버튼이 두개 보입니다.
"Manual"이라는 버튼과 "Automatic"이라는 버튼입니다.
Device Chooser 창이 나타나지 않는 경우는 이 두개의 라디오버튼이 "Manual"로 지정되지 않은 경우입니다.

"Manual"로 지정되면 매 실행시마다 어떤 장치(혹은 에뮬레이터)를 통해서 실행할 것인지를 물어보기 위해서 Device Chooser 화면이 나타납니다.

"Automatic"으로 지정되면 실행시마다 지정된 에뮬레이터로만 구동됩니다. (실제 단말은 Automatic)지정이 안됩니다. "Automatic"으로 지정된 후에는 그 하단에 있는 에뮬레이터 목록중에서 한가지를 지정해 주어야 합니다.

만약 "Automatic"으로 지정되고 실행할 에뮬레이터가 지정되지 않으면 이클립스에서 "Run"버튼을 눌렀을 때 아무런 응답이 없는 경우가 있으니 주의하시기 바랍니다.

반대로 이야기한다면 "Run"버튼을 눌렀을 때 이클립스가 아무런 응답이 없다면 이곳을 확인해 보면 된다는 이야기 입니다. 

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

이번 포스팅에서는 안드로이드 개발환경 셋팅 후에 첫번째 예제인 Hello World를 출력해 보는 과정에 대해서 소개해 보겠습니다. 이 포스팅의 목적은 안드로이드를 위한 새로운 프로젝트 생성 방법에 대한 이해에 있습니다. 

선행 작업

우선 이 포스팅에서 소개되는 내용을 확인하시기 위해서는 안드로이드의 개발환경이 설정되어 있어야 합니다. 또한 소스를 빌드해서 결과를 확인하기 위한 에뮬레이터가 필요합니다.

안드로이드의 개발환경을 구축하는 방법에 대해서는 다음의 포스팅을 참조하시기 바랍니다.

[Android TIP] 안드로이드 개발환경 설치하기 (for Windows)
[Android TIP] 안드로이드 개발환경 설치하기 (for Mac OS)

작업 결과물을 확인하기 위해서 에뮬레이터를 설정하는 방법은 다음의 포스팅을 참조하시기 바랍니다.

[Android TIP] 에뮬레이터 생성하기

안드로이드 프로젝트의 생성

이클립스에서 가장 왼쪽에 있는 툴바 아이콘이 "New"아이콘 입니다. 이 아이콘을 클릭합니다.




"New"아이콘을 클릭하면 "New"대화상자가 나타납니다. 화면의 중앙부에 있는 선택항목 중에서 "Android > Android Project"항목을 선택하고 "Next"를 누릅니다.



새로운 안드로이드 프로젝트의 이름을 지정하는 화면이 나타납니다.
"Project Name"은 이클립스상에서 이 작업을 구분하기 위한 단위 이름을 입력하는 공간입니다. 여기서는 "HelloWorld"라고 입력하겠습니다. 프로젝트 이름이 지정되면 "Next"버튼을 누릅니다.



안드로이드 프로젝트를 진행할 대상 버전을 지정합니다. 최상위 버전인 "Android 4.0.3"항목을 체크합니다.
체크를 한 다음 "Next"버튼을 누릅니다.



프로젝트 이름을 지정하고 나면 프로젝트의 정보를 입력하는 단계로 넘어가게 됩니다.
각각의 항목에 적절한 값을 입력한 후에 "Finish"버튼을 누르면 됩니다.
각 항목에 입력하는 값의 의미는 다음과 같습니다.

1. Application Name : 이 프로그램의 이름을 지정합니다. 실제로 이 어플리케이션이 단말기에 설치되었을 경우에 단말기의 프로그램 목록에 표시되는 이름입니다. 한글로 지정해도 무관합니다.
   
2. Package Name : 자바 패키지 이름입니다. 안드로이드는 OS에서 하나의 어플리케이션을 인식하는 단위가 패키지 단위가 됩니다. 그렇기 때문에 동일 패키지 이름이 설치하려는 단말기에 이미 존재한다면 설치가 진행되지 않습니다. (심지어 구글 마켓에 어플을 올릴 경우에도 다른 어플과 패키지 이름이 중복되면 등록이 거부됩니다.) 그러므로 패키지 이름은 가급적 고유한 이름을 지정해야 합니다.
   패키지 이름은 보유하고 있는 도메인의 역순.프로젝트이름(소문자)로 짓는것이 일반적입니다.
   
3. Create Activity : 프로그램의 시작점이 되는 Main Class의 생성여부에 대한 결정과 메인 클래스의 이름을 짓는 부분입니다. 이 항목을 체크하지 않고 지나갈 경우 다시 생성하기 위해서는 꽤 번거로운 작업들을 진행해야 하므로 반드시 프로젝트 생성시에 지정해 주셔야 합니다.
   
4. Minimun SDK : 이 프로그램을 구동할 수 있는 최소 안드로이드 버전값을 지정합니다. 아래 화면에서는 Android 2.1로 지정되어 있습니다. 이 의미는 이 어플이 (앞에서 지정한 대로) Android 4.0.3 버전을 대상으로 개발이 되지만 Android 2.1까지 지원하겠다라는 의미가 됩니다.

설정이 완료되면 "Finish"버튼을 눌러서 프로젝트 생성을 완료합니다.



프로젝트 설정이 완료되면 다음과 같이 이클립스상에 프로젝트가 생성됩니다.





이클립스에서 src > 패키지이름 > 메인클래스.java 파일을 열어보면 기본적으로 필요한 소스들이 작성이 되어 있는 것을 확인할 수 있습니다.

결과 확인

소스 수정 없이 바로 한번 실행해서 기본 모양을 확인해 보겠습니다.
안드로이드 에뮬레이터를 구동한 상태에서 이클립스에 있는 "Run"버튼을 누르면 프로그램이 에뮬레이터를 통해서 구동됩니다.

간혹가다가 에뮬레이터가 구동중인데도 새로 에뮬레이터가 뜨는 경우가 있습니다. 이럴 때는 그냥 그러려니 하면서 기존에 실행중이던 에뮬레이터를 종료하시면 됩니다.





"Android Device Chooser"라는 창이 나타나면서 구동중인 에뮬레이터의 목록이 나타납니다.
화면이 상하 두칸으로 나뉘어 있는데, 위쪽은 현재 구동중인 에뮬레이터의 목록이 나타납니다.
아래쪽은 구동되지 않고 있는 에뮬레이터가 타나납니다.
만약 현재 구동중인 에뮬레이터가 없다면 아래 화면에서 아래쪽 항목을 선택하고 "OK"버튼을 누르면 됩니다.



구동이 완료되면 에뮬레이터에 아래와 같이 실행 결과가 타나납니다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

다른 플렛폼들의 경우에는 개발한 소스를 테스트하기 위한 에뮬레이터가 완제품 형태로 제공되지만 안드로이드의 경우에는 개발자가 직접 에뮬레이터를 생성해 주어야 합니다.

이번 포스팅에서는 안드로이드 에뮬레이터를 생성해 보도록 하겠습니다.
이 과정은 Window와 Mac에서 공통으로 적용되는 내용입니다.

안드로이드 에뮬레이터 (AVD)의 추가

우선 이클립스에서 "Android Virtual Device Manager"를 실행시켜야 합니다. 이클립스의 AVD Manager 아이콘을 클릭합니다. (아래의 화면을 참고하세요.)





"Android Virtual Device Manager"라는 창이 나타나면 새로운 에뮬레이터를 생성하기 위해서 좌측에 있는 "New"버튼을 클릭합니다.




아래 화면과 같이 "Create new Android Virtual Device"라는 창이 나타납니다.
아래 화면을 참고해서 값을 입력(혹은 선택)하세요.

Name : 에뮬레이터에 부여하는 이름입니다. 한글만 아니라면 편하게 작성할 수 있습니다.
Target : 에뮬레이터에 탑제될 안드로이드 운영체제의 버전입니다. 여기서는 최신 버전을 적용했습니다.
SD Card > Size : 에뮬레이터에 탑제될 SD카드의 용량을 지정합니다. 

나머지 항목을 기본값대로 지정하면 해상도가 WVGA800 (480x800) 사이즈인 에뮬레이터가 생성됩니다.



에뮬레이터가 생성되면 생성된 항목을 선택하고 "Start"버튼을 누르세요.



실행 확인창이 나타납니다. 그냥 "Launch"버튼을 누르시면 에뮬레이터가 구동됩니다.



에뮬레이터가 구동되면서 안드로이드 운영체제가 부팅됩니다. 이 화면에서 인내력을 요구합니다. 부팅... 상당히 느립니다.





부팅이 완료되고 나면 안드로이드 운영체제의 모습을 볼 수 있습니다.

에뮬레이터가 PC모니터를 벗어나는 경우

(주로 해상도가 작은 노트북에서 실행할 경우) 에뮬레이터가 컴퓨터의 모니터보다 커서 화면을 빠져 나가는 경우가 간혹 있습니다.

이 경우에는 에뮬레이터의 "Launch Options"에서 Sacle 값을 지정해서 해결할 수 있습니다.
아래 화면은 에뮬레이터를 시작할 때 나왔었던 확인창입니다. "Scale display to real size"체크박스를 체크하고 "Screen Size"란에 7이라고 입력한 후에 실행합니다. (1~10 / 값이 클수록 확대됨)

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

이번 포스팅은 윈도우 운영체제에서 안드로이드를 개발하기 위한 개발환경을 설정하는 과정을 소개하고자 합니다. 이 블로그에 안드로이드 관련 글들이 은근히 올라와 있는 시점에서 뒤늦게 이렇게 안드로이드 설정관련 포스티을 올리는 까닭은 제가 진행하고 있는 강의에서의 보조교제로서 이 포스팅을 활용하기 위해서 입니다.

안드로이드의 개발환경 구축단계는 다음의 과정을 거쳐서 진행됩니다.

1. JDK의 설치와 환경변수 설정
2. Eclipse Classic 버전의 다운로드 및 설치
3. Android SDK의 다운로드 및 설치
4. Android Development Tool (ADT) 플러그인의 설치

여기서는 설치가 완료된 전체 패키지를 압축하여서 나중에 다른 환경에서도 압축만 풀면 즉시 안드로이드 개발을 진행할 수 있도록 만들겠습니다.

JDK의 설치와 환경변수 설정

안드로이드 역시 자바기반에서 진행되는 개발이니만큼 JDK의 설치및 설정이 필수 입니다. JDK의 다운로드 및 설치는 다음의 포스팅을 참조하시기 바랍니다.

[JAVA] 개발환경 준비하기 - JDK의 설치

이클립스의 다운로드 및 설치

안드로이드 개발 툴킷은 이클립스의 플러그인 형태로 제공됩니다. 그렇기 때문에 안드로이드 개발을 위해서는 Eclipse를 다운로드 받아서 설치해야 합니다. 이클립스는 http://www.eclipse.org에서 다운로드 받을 수 있습니다.

사이트에 접속한 후 상단 메뉴에서 "Download"를 클릭하여 다운로드 페이지로 이동합니다. 다운로드 페이지에 나열되는 패키지들 중에서 "Eclipse Classic"버전을 설치되어 있는 운영체제의 버전에 맞게 선택합니다.





운영체제에 맞는 버전을 선택하면 다운로드 링크가 제공되는 페이지로 이동합니다. 여기서 아래 화면을 참조하여 이클립스를 다운로드 받습니다.





이클립스는 설치 패키지가 아닌 압축파일의 형태로 제공됩니다. C드라이브에 eclipse+andsdk-r16-win32-x86-64bit 라는 폴더를 만들고 그 안에 압축을 풀어둡니다. 이 때 폴더이름은 편하게 지으시면 됩니다. 다만 폴더 이름을 명시할 때 한글이나 공백이 들어가지 않도록 주의하시기 바랍니다.

이클립스의 압축이 모두 풀리면 그 안에 workspace라는 폴더를 생성합니다. 이 폴더에 소스파일들이 저장되도록 지정할 것입니다.





이제 이클립스를 실행하면 아래 화면과 같이 workspace를 물어보는 화면이 나타납니다. 이 화면에서 workspace의 경로를 앞에서 생성한 디렉토리로 지정하여 줍니다.
만약 이 단계를 무시하고 지나쳤다면 이클립스의 "File > Switch Workspace"메뉴를 통해서 다시 지정해 줄 수 있습니다.

Android SDK의 다운로드 및 설치

이클립스의 설치가 잘 마무리되면 이번에는 Android SDK를 다운로드 받아서 설치할 차례입니다.
Android SDK는 초기에는 단순히 압축파일의 형태로만 제공이 되었습니다. 후에 이 압축파일이 설치 패키지 형태로 변경이 되었는데 그렇다고 해서 변한것은 없습니다. 즉 설치 완료 후에 그 파일을 다시 압축해서 다른곳에 압축을 풀어도 정상적으로 사용이 가능하다는 것이죠.

이 점을 이용해서 이클립스가 설치된 디렉토리안에 android-sdk-windows라는 폴더를 만들고 그 경로에다 Android SDK를 설치할 것입니다.

그렇게 되면 설치 완료 후에 이클립스와 함께 통째로 압축하면 언제든지 재사용이 가능해 집니다.





안드로이드 SDK를 다운로드 받기 위해서 http://developer.android.com 에 접속합니다. 사이트에 접속한 후에 두번째 메뉴인 SDK를 클릭하면 운영제체 버전에 맞는 SDK를 다운로드 받을 수 있는 페이지가 나타납니다.

여기서는 Windows 환경에서 설치를 진행할 것이므로, Installer_r16_windows.exe 파일을 다운로드 받습니다.





다운로드가 완료되면 다운로드 받은 파일을 실행하여서 설치를 시작합니다.





설치 과정중에 JDK의 설치 여부를 확인합니다. 만약 JDK의 설치가 되어 있지 않다면 JDK를 설치하신 후에 다시 이 패키지를 실행하셔야 합니다.





SDK가 설치될 경로를 묻는 화면이 나타납니다. 앞에서도 이야기 했듯이 여기서는 C:\이클립스폴더\android-sdk-windows 경로에 이 패키지를 설치할 겁니다. 아래 화면을 참고하여서 "Browse"버튼을 누릅니다.





폴더 찾아보기 창이 나타나면 앞에서 생성했던 android-sdk-windows의 폴더를 지정하여 줍니다.





지정된 경로를 확인하고 "Next"버튼을 눌러서 설치를 계속 진행합니다.





시작메뉴 폴더를 물어봅니다. 가볍게 "Next"버튼을 누릅시다.





설치가 진행됩니다. 완료되면 여기서도 "Next"를 누릅시다.





설치가 완료되면 Android의 버전별 API를 내려받아야 합니다. 설치 완료 후 API 다운로드 창을 구동시키기 위한 "Start SDK Manager" 체크박스를 체크하고 "Finish"버튼을 눌러줍니다.





설치 프로그램이 종료되면서 Android SDK Manager라는 창이 나타납니다. 기본적인 SDK이외에 Android의 버전별 API와 추가적인 툴들을 내려받도록 하는 화면입니다.

Android API는 최신 버전인 Android 4.0.3 버전과 일반적으로 개발시에 최 하위 버전으로 적용하는 2.1버전만을 다운로드 받습니다. 1.6과 1.5는 지나치게 하위버전이여서 탑제되어 있는 단말기도 드물기 때문에 배제합니다.

실제 프로젝트 진행은 4.0.3으로 진행하면서 최하위 지원 버전을 2.1로 지정하기 위해서 위와 같이 체크합니다.
그 외에 Extra라는 추가 기능들도 포함시킵니다.





이용약관에 동의하고 다운로드를 진행합니다.





실제 다운로드가 진행됩니다. 이 과정이 상당히 오래 걸립니다. 저는 이거 걸어놓고 스타를 한판 했습니다. -.-;;;
다운로드가 완료되면 별다른 메시지가 나타나지 않고 진행되던 프로그래스바가 회색으로 바뀝니다. 그럼 이 창을 그냥 닫아주면 됩니다.

ADT의 다운로드와 설치

ADT란 Android Developement Tools의 줄임말로 이클립스에 설치되어 Android SDK를 다룰 수 있도록 도와주는 이클립스 플러그인을 말합니다.

ADT를 다운로드 받고 설치하기 위해서는 이클립스를 사용해야 합니다. 이클립스의 Help메뉴 하위의 "Install New Software"를 선택합니다.





"Install"창이 나타나면 우측 상단의 "Add"버튼을 누릅니다.





Add Repository창이 나타나면 Name 속성에 "ADT"라고 입력하고 Location 속성에는 다음의 주소를 입력합니다. 여기서 입력한 주소로부터 이클립스 플러그인을 내려받게 됩니다. 입력이 완료되면 "OK"버튼을 눌러 창을 닫고 원래의 화면으로 돌아갑니다.

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

원래의 화면으로 돌아가면 화면 중앙의 목록에 잠시 "Pending..."이라는 메시지가 나타났다가 다운로드 받을 수 있는 항목들이 체크박스와 함께 나타납니다. 모든 항목을 체크한 후에 "Next"버튼을 눌러서 다운로드 받습니다.





선택한 항목을 확인하는 페이지 입니다. "Next"버튼을 누릅니다.





이용약관을 확인하는 페이지 입니다. 동의한다는 의미의 "I accept ..."에 체크하고 "Finish"를 누릅니다. 이 페이지의 내용을 꼼꼼히 읽어보실 분들은... 안말립니다. -_-;;;





다운로드가 시작됩니다. 이 과정이 상당히 오래 걸립니다. 식사라도 하고 오셔야 합니다.





다운로드 중에 Anti Virus 프로그램에 대한 경고가 나타나는 경우가 있습니다. 가볍게 "OK"를 누르시면 됩니다.





다운로드가 완료되면 이클립스를 재시작해야 한다는 메시지가 아래 화면과 같이 나타납니다. "Restart Now"를 눌러서 이클립스를 재실행 합니다.





이클립스가 재실행 되고 나면 아래 화면과 같이 Android API를 내려받는 창이 자동으로 나타납니다. 우리는 앞에서 Android SDK를 설치하면서 미리 받아두었기 때문에 여기서는 "Cancel"을 눌러서 창을 닫습니다.





이제 여기까지 진행한 후에 이클립스를 닫고 이클립스가 설치된 디렉토리를 통째로 압축하면 다른 PC에 가서도 동일한 경로에 압축만 풀어주면 바로 안드로이드 개발을 진행할 수 있습니다.

저는 압축을 풀기 전에 이클립스의 폰트를 변경하고 소스파일의 왼쪽에 라인수가 표시되는 설정을 추가한 후에 압축했습니다.

안드로이드의 세계에 오신것을 환영합니다.

이제 즐깁시다~!!!

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

이번 프로젝트를 하면서 팝업창이 일반 Alert Dialog가 아닌, 직접 UI를 구현한 형식의 Dialog창이여야 했습니다.
AlertDialog.Builder 클래스를 사용해서 View를 넣어주는 방식도 있었지만, 문제는 Dialog창에서 프로그램 로직을 돌려야 할 경우 어떻게 처리해야 하는가에 대한 부분이였습니다.

예를 든다면 팝업창이 뜨면서 서버로부터 데이터를 받아와서 팝업창의 내용을 뿌려야 한다던가 하는 식의 처리였죠.

웹에서 자료를 찾다 보니 딱 제가 원하는 방식이 있어서 정리해 봅니다.

먼저 팝업으로 사용할 Activity를 하나 만들어야 합니다.
그리고 AndroidMenifest.xml에서 해당 클래스를 Activity로서 등록하는 Attribute에 android:theme="@android:style/Theme.Dialog" 라는 속성을 추가해 줍니다.

<ACTIVITY
	android:name="Activity 클래스 이름"
	android:theme="@android:style/Theme.Dialog"></ACTIVITY>

그런 다음 팝업창으로 동작할 해당 Activity 클래스의 소스파일에 onApplyThemeResource 라는 메소드를 재정의 해 줍니다.

@Override
protected void onApplyThemeResource(Resources.Theme theme, int resid, boolean first)
{
	super.onApplyThemeResource(theme, resid, first);
		
	// no background panel is shown
	theme.applyStyle(android.R.style.Theme_Panel, true);
}

이제 이 부모창에서 이 Activity를 Intent를 통해서 startAcvity() 메소드로 호출하면 팝업창으로서 동작합니다. 물론 페이지의 디자인이 화면의 전체 사이즈보다 작아야 하겠죠.

startActivityForResult() 메소드를 활용하면 팝업창으로 부터의 결과를 부보창이 받아볼 수 도 있게 됩니다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

UI를 구성할 때, 그래픽이 적용된 버튼을 만들어야 할 경우가 있습니다.
이미지버튼의 src속성을 사용하고 백그라운드를 투명하게 처리하면, 선택되었을 때의 강조되는 느낌이 나타나지를 않게 되기 때문에 이럴 때는 selector라는 xml파일을 사용하게 됩니다.

예를 들어서 button_off.png 와 button_on.png 파일이 있다고 가정해 봅시다.

이 두개의 이미지 파일을 사용해서 롤오버 버튼을 만들어 보겠습니다.

일단 이 이미지파일들은 drawable-hdpi 폴더에 넣겠습니다.
이제 이 drawable-hdpi 폴더에 xml파일을 하나 추가하겠습니다. (drawable에 반드시 이미지 파일만 있어야 하는 것은 아니라는 것을 이번에 알았습니다. (__);; )

다음의 형식에 맞춰서 xml파일을 만들고, 파일 이름을 button_bg.xml 이라고 지정하겠습니다.

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:state_focused="false" android:state_pressed="true"
        android:drawable="@drawable/button_on" />
    <item android:drawable="@drawable/button_off" />
</selector>

이제 버튼 컨트롤의 background 속성에 저 XML파일의 id값을 지정해 주면 됩니다.

Button btn = new Button(getApplicationContext());
btn.setBackgroundDrawable(R.drawable.button_bg);

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

오늘 올릴 포스팅은 안드로이드에서 간단한 인트로 화면을 만드는 법입니다.

대부분의 프로그램들은 인트로 화면에서 프로그램의 초기화 작업을 수행하기 때문에 그 초기화 작업이 수행되는 시간 (대략 1~2초 정도) 동안 프로그램의 성격을 나타내는 첫 인트로 화면과 함께 로딩바를 보여줍니다.

여기서는 초기화 작업을 가정하여서 인트로화면에서 대략 3초간의 딜레이 시간을 적용하고 그 시간이 지난 후에는 프로그램의 메인화면에 해당하는 페이지로 이동시켜 보겠습니다.

 

필요한 리소스의 준비

인트로 화면을 표현하기 위해서 프로그램의 대문역할을 할, 인트로 이미지를 마련해야 합니다.

멋진 이미지를 만들면 좋겠지만, 그림 그리는 실력이 좋지 못해서, 저는 왼쪽에 보이는 것과 같이 제 임의로 intro.png라는 이미지를 480x768사이즈로 작업했습니다.

이미지 리소스를 마련할 때, 주의할 점은 파일이름에 한글을 사용할 수 없고, 영어 소문자와 언더바("_"), 숫자로만 파일이름이 지정되어야 하며 첫글자는 반드시 영어 소문자로 시작해야 한다는 점 입니다.

확장자도 대문자로 할 수는 없으니 주의해야 합니다.

인트로 이미지를 다운로드 받으시려는 분은 아래 링크를 클릭하시기 바랍니다.

안드로이드 프로젝트의 생성

이클립스에서 "New" 툴바 아이콘을 클릭하여서 새로운 "Android Project" 를 생성합니다.





프로젝트의 정보는 아래와 같이 입력했습니다. 




 

프로젝트에 리소스를 등록

생성된 안드로이드 프로젝트를 이클립스의 Package Explorer상에서 보면 res 라는 디렉토리가 있습니다. 이 디렉토리가 안드로이드에서의 리소스를 관리하는 역할을 합니다. 이 디렉토리 안의 drawable-hdpi 디렉토리에 우리가 사용하기 위한 이미지 리소스를 넣어야 합니다.

아래 그림과 같이 intro.png 파일을 드래그 & 드롭해서 넣습니다.




 

레이아웃의 편집

res/layout 폴더에는 화면에 보여주는 모습이 정의되어 있는 XML 파일들이 위치합니다. 이 파일의 내용을 자바 클래스가 읽어서 그 내용대로 화면에 표시하는 구조 입니다.

프로젝트를 생성하게 되면, 1개의 화면을 구성하기 위한 소스파일 (프로그램의 진입점이 됩니다.) 과 이 소스파일에서 읽기 위한 main.xml 파일이 생성됩니다. 이 main.xml 파일을 수정해서 인트로 화면을 구성하겠습니다.

/res/main.xml 파일을 엽니다. (처음 열리는데 시간이 좀 소요됩니다.)

화면의 중앙에 레이아웃의 모습이 표시되면 이클립스에서 기본으로 생성해 준, "Hello World..." 문자열이 표시됩니다. 그 문자열이 표시되고 있는 부분을 클릭해서 삭제합니다.




 

레이아웃에 이미지 적용

XML 레이아웃 편집화면 상에서 우측의 "Outline"이라는 부분에 화면에 표시될 컨트롤들의 계층구조가 트리형태로 표시됩니다.

Outline에 표시되고 있는 "LinearLayout" 이라는 항목을 더블클릭하면, Outline 창 부분에 해당 컨트롤의 속성을 지정할 수 있는 "Properties" 창이 나타납니다.





"Properties"창에서 "Background"라는 항목을 찾아서 우측의 "..."버튼을 클릭합니다.




 리소스 선택창이 나타나면 "Drawable"이라는 항목의 트리를 확장해서 앞에서 등록해준 "intro.png"파일에 해당하는 "intro"라는 항목을 선택하고 "OK"버튼을 누릅니다.





그럼 아래와 같이 화면에 우리가 준비한 인트로 이미지가 배경화면으로서 등록됩니다. 이렇게 등록한 이미지는 화면 해상도에 상관없이 화면을 가득 채운 상태로 표시됩니다.

두번째 화면의 준비

프로젝트를 만들면서 생성된 첫 화면에 대한 XML파일과 자바 소스는 인트로 화면으로 사용할 계획이기 때문에, 인트로화면 다음에 보일 실질적인 프로그램의 메인화면 역할을 할 두번째 화면을 준비해야 합니다.

두번째 화면의 모습을 정의하기 위해서 레이아웃 XML 파일을 새롭게 추가합니다.

이클립스의 "New" 툴바 아이콘을 클릭하고, "New" 대화상자가 나타나면 Android > Android XML File 을 선택합니다.





"New Android XML File" 대화상자가 나타나면, 파일이름을 넣습니다. 여기서는 sub.xml 이라고 넣었습니다.

파일의 타입을 정의하는 라디오버튼에서 "Layout"항목을 선택하고, "Finish"버튼을 클릭합니다. 





대화상자가 닫히면, "/res./layout/sub.xml" 파일이 생성되어 있습니다. 이 파일을 더블클릭해서 열어보면 비어있는 화면인 것을 알 수 있습니다.

레이아웃 편집기의 왼쪽에 나타나는 컨트롤 목록에서 "Form Widgets" 그룹안에 있는 "Large"라는 항목을 화면으로 드래그 & 드롭 합니다.

"Form Widget"은 안드로이드에서 사용하는 기본 컨트롤들을 담고 있는 그룹이며, 이중에서 "TextView", "Large", "Medium", "small" 이라는 항목은 텍스트를 표시하기 위한 "텍스트 뷰"라는 컨트롤 입니다. 모두 동일한 컨트롤이며, 기본적인 속성 값들에 대해서 차이를 보이는 부분입니다.

컨트롤을 추가한 후에 우측의 Outline 트리에서 추가된 컨트롤을 확인할 수 있습니다. "textView1"이라는 이름으로 추가 되어 있는 것을 확인할 수 있습니다.




우측의 Outline에서 textView1을 더블클릭하여 속성을 정의하기 위한 "Propertie" 탭으로 이동합니다. 여기서 "Text"라는 속성을 찾아서 우측의 "Hello Android!!!" 라고 입력합니다.




 

새로운 화면을 위한 소스파일 추가

이클립스의 "Package Explorer"에서 /src 폴더 하위의 현재 패키지 이름을 마우스 우클릭하여 "New" > "Class" 항목을 선택합니다.





새로운 클래스 생성을 위한 대화상자가 나타나면, 아래 화면을 참고해서 값을 입력합니다.

MySubActivity 라는 클래스를 android.app.Activity 라는 클래스를 상속시켜서 생성합니다.





새로운 클래스가 추가되면, 소스창에 다음의 소스코드를 작성합니다.

프로젝트를 처음 만들때 생성되는 소스파일의 내용과 동일합니다. 

package study.introex;

import android.app.Activity;
import android.os.Bundle;

public class MySubActivity extends Activity {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.sub);
     }
}

 

10라인의 소스코드를 보면 setContetView 라는 함수에 R.layout.sub 라는 값이 전달됩니다. R.layout.sub 라는 값은 앞에서 추가한 레이아웃 XML 파일을 의미합니다. XML파일이 추가되면 "R.layout.파일명"의 형태로 값이 생성되며, 이 값을 setContetView 메소드에 전달함으로서 Activity를 상속한 자바 클래스가 XML파일을 읽어들일 수 있게 합니다.

 

새로운 화면을 위한 AndroidManifest.xml 파일 작업

안드로이드에서는 소스코드와 레이아웃을 아무리 잘 작성해도, 실제 프로그램이 실행될 때는 해당 화면을 호출하게 되면 런타임 에러가 발생합니다. 그 이유는 프로그램이 OS에 설치될 때, OS가 프로그램의 메타정보를 담고 있는 AndroidManifest.xml 파일을 읽어들여서 어떤 클래스들이 화면이라고 인식해야 하기 때문입니다. 그러므로, 화면을 추가하는 단계는 레이아웃 XML 생성 > 소스코드의 생성 > 화면 정보를 AndroidManifest.xml 파일에 등록 의 순서로 진행됩니다.

Package Explorer에서 "AndroidManifest.xml"파일을 열어서 편집창이 열리면, 화면 하단에 있는 5개의 탭 중에서 두번째 "Application" 탭으로 이동한 후에, 화면 하단쪽에 있는 "Application Nodes" 하위의 "Add"버튼을 누릅니다.

 

 

새로운 창이 열리면, "Activity"항목을 선택합니다.





만약, 위와 같은 화면이 나타나지 않고 아래 화면과 같이 라디오버튼과 Intent Filter, Meta data 라는 두 항목이 나타나면, 라디오버튼을 첫번째 것을 선택합니다. Application Nodes 에서 특정 항목을 선택한 후에 "Add"버튼을 눌러서 그 하위의 정보를 등록하기 위한 창이 디폴트로 나타나기 때문이니 크게 신경쓸 부분은 아닙니다.

 

 

"Application Nodes"에 새로운 "Activity"항목이 추가되면, 추가된 "Activity"를 선택하고 우측의 "Name" 항목의 "Browse"버튼을 클릭합니다.





찾아보기 창이 열리면서 현재 프로젝트 안에 있는 Activity를 상속받는 클래스들의 목록이 나타납니다.

여기서 우리가 앞에서 추가한 "MySubActivity"클래스를 선택해 줍니다.




 

 

로딩 다이얼로그의 추가

인트로 화면에서 작업이 진행중이라는 것을 사용자에게 알려주기 위해서 로딩다이얼로그를 현재 프로젝트에 추가합니다.

로딩 다이얼로그를 추가하는 방법에 대해서는 다음의 포스팅을 참고하시기 바랍니다. 

[안드로이드 GUI] 안드로이드에서 아이폰 스타일의 로딩바 만들기

 

메인 클래스 소스의 변경

이제 모든 준비가 끝났으니,  프로그램 실행시에 로딩바를 표시하고, 3초 정도의 시간 후에 다음 페이지로 이동하는 작업을 처리하겠습니다.

프로젝트를 만들때 자동으로 생성된 IntroExActivity 소스를 아래의 내용으로 작업합니다.

package study.introex;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;

public class IntroExActivity extends Activity implements Runnable {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        // Acitivity(화면) 초기화
        super.onCreate(savedInstanceState);

        // main.xml 파일을 읽어들인다.
        setContentView(R.layout.main);

        // 로딩 다이얼로그를 표시한다.
        CDialog.showLoading(this);

        // 딜레이 시간 수행을 위한 스레드 작업
        (new Thread(this)).start();
    }

    @Override
     public void run() {
        // 3초 딜레이
        try {
            Thread.sleep(3000);
        } catch (Exception e) {}

        // 다이얼로그 닫음
        CDialog.hideLoading();

        // 화면 이동
        Intent intent = new Intent(this, MySubActivity.class);
        startActivity(intent);

        // 단말기 Back버튼을 눌렀을 때, 인트로 화면으로 돌아오지 않도록 인트로 화면을 종료
        finish();
    }
}

 

 

실행결과 확인

실행하면 다음과 같은 결과를 확인할 수 있습니다.

인트로 화면이 나타나고, 로딩바가 나타난 상태에서 3초 후에, 두번째 화면으로 이동합니다.

     
 


 

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

학생에게 질문을 받아서 올리는 포스팅입니다.

안드로이드는 시스템에서 자체적으로 스트리밍을 지원합니다. App을 만들면서 App안에서 스트리밍 기능을 사용하고자 할 경우에는 VideoView라는 컨트롤을 사용하면 되지만, 시스템 자체적으로 이미 좋은 플래이어가 있는데 궂이 그렇게 일일이 동영상 재생을 위한 기능을 구현해야 할 필요까지 없는 경우에는 시스템에 내장된 플래이어를 활용하는 방법이 있습니다.

내장된 동영상 플레이어를 활용하는 방법은 Intent를 사용합니다.

다음의 코드를 통해서 시스템 내장 플래이어를 부를 수 있습니다.

Intent it = new Intent(Intent.ACTION_VIEW);
Uri uri = Uri.parse(재상할 동영상의 온라인상의 주소);
it.setDataAndType(uri, "video/*");
startActivity(it);

주의할 점은 연결된 동영상의 주소가 해당 단말에서 지원하는 코덱으로 인코딩된 동영상이여야 한다는 점입니다.

단말별로 지원하는 코덱은 제조사에서 어떤 코덱을 지원하느냐에 따라 다르겠지만, 기본적으로 *.gp3와 *.mp4 포멧은 지원합니다. 그리고 대부분의 단말이 *.avi 포멧도 지원하고 있습니다. 연결된 동영상의 URL이 지원하지 않는 코덱일 경우 해당 어플은 에러를 발생하니 주의해야 합니다.

실행화면을 캡쳐해 봤더니, 실제 영상화면은 캡쳐가 안되더군요.. ^^;;

 

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

요즘 안드로이드 프로젝트를 한건 하고 있습니다.
아이폰과 동시 개발이 진행되고 있는 건이여서 그런지, 디자이너분께서 보내주신 컴포넌트 요소들의 그래픽이 모두 아이폰의 그것과 닮아있습니다. 더더군다나 더 골치스러운것은 팝업창의 디자인도 모두 아이폰처럼 되어 있어서 직접 새로 해야 한다는 점입니다.

아이폰의 기본 컴포넌트 PSD파일은 잘 찾아서 사용하면서 안드로이드용은 못찾겠다고 하는 바람에 디자이너에게 전달할 자료를 찾다가 안드로이드용 컴포넌트 PSD 파일을 찾았습니다.

아래 소개되는 자료들을 모두 하나의 압축파일에 폰트까지 담아서 함께 넣었습니다.

관심있으신 분들께는 좋은 참고자료가 될 것 같습니다.

Android-Component-PSD.vol1.egg

Android-Component-PSD.vol2.egg

Android-Component-PSD.vol3.egg

#01. Android GUI PSD V1.0

안드로이드 1.5 GUI요소들에 기반한 PSD파일입니다. 이 파일이 가장 기본적으로 많이 사용되고 있는 파일이라고 합니다.




#02. Android GUI PSD v2.0 by Vladimir Grishin

Android GUI PSD V1.0에 몇가지 요소가 더 추가된 파일입니다.




#03. Android GUI PSD v2.0 by Vladimir Grishin

크기조절이 가능한 백터 요소를 기반으로 만들어진 안드로이드 GUI 요소들입니다.




[원문출처] http://ntt.cc/2010/08/03/6-free-android-gui-psd-templates-for-designers.html

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

안드로이드에서 로딩중임을 사용자에게 알리기 위한 가장 쉬운 방법은 팝업창 스타일이다.

이 기본형의 로딩 다이얼로그는 팝업 다이얼로그가 나타나면서 좌측에 원 형태의 프로그래스바가 위치하고, 우측에 메시지를 보여주는 형태이다.

실무를 진행하다보면 은근히 자주 받게 되는 요구사항중이 하나가 아이폰 스타일의 프로그래스바를 적용해 달라는 것이다.

방법이 없을까 하고 웹상에서 여기저기 기웃거리다가 가장 적용하기 쉽고 편한 방법을 발견하여 사용해보니 이거 물건이다.

내 나름대로 적용 방법을 정리해서 소개해 본다.

 

적용 방법 개요.

아이폰 스타일의 프로그래스 바는, 소스코드를 통해서 처리한다.

우선 Dialog클래스의 객체를 하나 생성한 후에, 그 안에 addContentView()메소드를 사용해서 ProgressBar의 객체를 직접 추가하여 표시하는 것이다.

중요한 부분은 Dialog클래스의 객체를 만드는 과정에 있는데, Dialog클래스의 생성자에 다이얼로그 창 자체를 투명하게 만들기 위한 Style이 기술된 리소스 XML파일의 리소스 아이디를 전달하는 것이다.

 

리소스 XML파일의 준비

이클립스 툴바 메뉴상에서 "New"아이콘을 클릭하여 "New"대화상자를 띄운 후에, "Android > Android XML File"항목을 선택한다.

 




새로운 XML 파일을 등록하기 위한 대화상자가 나타나면, 파일이름을 적절히 지정한다. (여기서의 파일이름은 리소스 아이디와 연관이 없으므로 편하게 등록한다.)

주의할 점은 XML파일의 Type을 "Values"항목으로 지정해야 한다는 것이다.

이렇게 등록하면 추가한 XML파일은 이클립스 Package Explorer상에 "/res/values/파일명.xml" 의 경로에 생성된다.





XML파일이 추가된 것이 확인되면, 해당 XML파일을 열어 소스 편집 화면으로 들어가자.

XML 소스 편집화면 상에서 다음의 XML코드를 입력한다.

<?xml version="1.0" encoding="utf-8"?>
<resources>
<style name="TransDialog">
	<item name="android:windowFrame">@null</item>
	<item name="android:windowIsFloating">true</item>
	<item name="android:windowContentOverlay">@null</item>
	<item name="android:windowTitleStyle">@null</item>
	<item name="android:windowAnimationStyle">@+android:style/Animation.Dialog</item>
	<item name="android:windowBackground">@+android:color/transparent</item>
</style>
</resources>

XML 코드의 3라인에 위치한 <style>태그의 name 속성을 보면, "TransDialog"라고 명시되어 있다. 이 값이 R.java파일에 리소스 아이디로 적용되므로 반드시 기억하자.

이 XML 리소스의 접근 값은 "R.style.TransDialog"가 된다.

로딩 다이얼로그 모듈을 위한 클래스 추가

이제 새로운 클래스를 등록해서, static 메소드 두가지를 작성할 차례이다.

이렇게 등록한 클래스의 메소드를 통해서 어디서든지 (객체생성 없이) 로딩 다이얼로그를 화면에 보여주고, 숨길 수 있도록 작업할 것이다.

이클립스의 Package Explorer상에서 /src 폴더 밑의 현재 패키지 이름을 마우스로 우클릭한 후에 "New > Class"메뉴를 선택한다.






새로운 클래스를 등록하기 위한 창이 나타나면 클래스 이름 항목에 "CDialog"라고 입력하고 "Finish"버튼을 누르자. CDialog.java 파일이 생성된 것을 확인할 수 있다.




이제 이 파일에 로딩을 화면에 보여주고 숨기기 위한 소스코드를 작성한다.

CDialog 모듈의 설계

CDialog 클래스는 하나의 static 멤버변수 객체와 두개의 static 메소드를 갖는다.

private static Dialog m_loadingDialog

직접적으로 화면에 보여질 Dialog 객체이며, 공통요소로 사용하기 위해서 static으로 선언한다.

public static void showLoading(Context context)

화면에 로딩 다이얼로그를 표시하기 위한 메소드이다. Dialog 객체과 ProgressBar 객체 사용에 필요한 Context를 파라미터로 요구한다.

public static void hideLoading()

현재 화면에서 로딩 다이얼로그를 닫는다.

위와 같은 설계 요소를 적용한 CDialog 클래스의 원형은 다음의 소스코드와 같다.

import android.app.Dialog;
import android.content.Context;
import android.view.ViewGroup.LayoutParams;
import android.widget.ProgressBar;

public class CDialog {
	private static Dialog m_loadingDialog = null;
	public static void showLoading(Context context) {}
	public static void hideLoading() {}
}

showLoading 메소드 작성

showLoading 메소드는 Context 객체가 파라미터로 필요하다. 그 이유는 이 메소드 안에서 생성해야 하는 Dialog 객체와 ProgressBar 객체가 Context를 생성자 파라미터로서 요구하기 때문이다.

이 메소드에서는 if 조건문으로 Dialog 객체가 null인지 여부를 검사해야 한다. 만약 이 객체가 null이라면, 현재 Dialog가 화면상에 표시되고 있지 않은 것이라 여기고, 로딩을 표시하기 위한 객체와 컨트롤을 생성한다.

android.app.Dialog 클래스
Dialog(Context context, int res_id)

다이얼로그 창을 생성하기 위한 생성자이다. 이 객체를 생성하기 위한 생성자 파라미터로 Context객체와 앞에서 작성한 투명 스타일의 리소스 아이디를 전달한다.

android.widget.ProgressBar 클래스
ProgressBar(Context)

다이얼로그 창에 넣을 PgoressBar 컨트롤의 생성자이다. Context를 생성자 파라미터로 요구한다.

android.app.Dialog 클래스
void addContentView(View view, LayoutParams parmas)

다이얼로그 창에, 컨트롤을 추가한다. 첫번째 파라미터인 view 객체는 다이얼로그에 추가할 컨트롤 요소이다. 두번째 파라미터인 params 객체는 컨트롤에 대한 사이즈 정보를 담은 LayoutParams 객체이다.

android.view.ViewGroup.LayoutParams 클래스
LayoutParams(int width, int height)

컨트롤의 크기를 결정하기 위한 LayoutParams 객체를 생성한다. 파라미터에 가로 크기와 세로크기를 지정해 준다.
대부분 컨트롤의 기본 사이즈를 적용하기 위한 LayoutParams.WRAP_CONTENT 값을 지정한다.

android.app.Dialog 클래스
void setCancelable(boolean flag)

다이얼로그 창을 하드웨어 BACK 키를 통해서 닫을 수 있는지의 여부를 결정한다. false로 파라미터가 전달될 경우 다이얼로그 창은 BACK 키를 통해서 닫을 수 없게 설정된다.

android.app.Dialog 클래스
void show()

다이얼로그 창을 화면에 표시한다.

위의 내용을 기반으로 하여 완성된 showLoading 메소드의 소스코드는 다음과 같다.

public static void showLoading(Context context) {
	if (m_loadingDialog == null) {
		m_loadingDialog = new Dialog(context, R.style.TransDialog);
		ProgressBar pb = new ProgressBar(context);
		LayoutParams params = new LayoutParams(
		LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT);
		m_loadingDialog.addContentView(pb, params);
		m_loadingDialog.setCancelable(false);
	}

	m_loadingDialog.show();
}

hideLoading 메소드 작성

hideLoading 메소드의 작업은 간단하다.

Dialog 객체의 null 여부를 확인하여, null이 아닐 경우 다이얼로그 창을 닫기 위하여 dismiss()메소드를 호출한다.
그런 다음 Dialog 객체에 null을 할당하여 점유하고 있는 메모리를 반납한다.
이 과정을 소스로 정리하면 다음과 같다.

public static void hideLoading() {
	if (m_loadingDialog != null) {
		m_loadingDialog.dismiss();
		m_loadingDialog = null;
	}
}

모듈 적용하기

완성된 모듈은 Activie 클래스 상에서 다음과 같이 호출하여 사용할 수 있다.

// 다이얼로그 창 표시
CDialog.showLoading(this);

// 다이얼로그 창 숨기기
CDialog.hideLoading();

실행 결과를 아래 이미지와 같이 나타난다. 다만, 주의할 점은 프로그래스바 컨트롤의 모양은 단말 제조회사나 안드로이드 버전에 따라 다르게 타난다는 점이다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

리소스 XML파일을 작업이 숙련되다 보면 경우에 따라서는 GUI툴을 사용하는 것 보다는 직접 XML 코드를 수정하는 것이 편하게 느껴질 때가 있다.

하지만 GUI에서 작업하던 XML코드를 막상 소스 편집창에서 열어보면, 소스코드들이 모두 한줄로 되어 있어서 알아보기가 쉽지 않다.

이클립스의 환경설정을 통해서 XML 소스를 보기 편하기 자동으로 줄바꿈 처리하여 관리할 수 있다.

이클립스의 "Windows > Preperences"메뉴를 선택하고, 좌측의 트리에서 "XML > XML Files > Editor" 항목으로 이동한다. 페이지 우측에 아래 그림과 같은 화면이 나타나면, 맨 위에 위치한 "Split multiple attributes each on a new line" 항목을 체크한다.





이클립스 설정을 마친 후, 원하는 XML 파일을 열고, Ctrl+Shift+F 를 누르면 XML파일의 줄바꿈이 아래와 같이 속성단위로 줄바꿈이 되어 변경된다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

개발용으로 단말을 사용하다 보면, 이것저것 테스트를 목적으로 여러 어플들을 설치하게 됩니다. 그러다 보면 나중에는 단말을 포멧하게 되는 경우가 종종 생기는데요, 그런 상황에서 사용하는 공장초기화 방법을 소개합니다.

갤럭시 탭

1. 시스템 전원을 끈 상태에서 "사이드 볼륨 업키" + "사이드 전원키"를 1~2초 가량 누릅니다.
   (주의할 점은 너무 오래 누르고 있으면 곧바로 재부팅이 되어 버립니다.)

2. "Android system recovery <3e>"라는 제목이 있는 시스템 메뉴가 나타납니다. (배경에 노란 느낌표 + 안드로이드 캐릭터 이미지 가 있습니다.)

3. 시스템 메뉴에서 "사이드 볼륨 다운키"를 눌러 "wipe data/factory reset" 항목을 선택하고 "홈키"를 누릅니다.

4. 다음 화면이 나오면 다시 "사이트 볼륨 다운키"를 눌러서 "Yes -- delete all user data"항목을 선택하고 "홈키"를 누릅니다.

5. 약 5~10초 가량 시스템 복구 작업이 진행됩니다.
   작업 진행의 완료는 화면 왼쪽 하단에 노란색으로 상태 메시지가 나오는데, 여기에 "Data wipe complete"라는 메시지가 출력됩니다.

6. 시스템 복구가 완료되면 화면 왼쪽 상단의 파란색 메뉴에서 "reboot system now"항목을 선택하고 "홈키"를 누릅니다.

7. 시스템이 재부팅 되면서 초기화 작업이 종료됩니다.

8. 이 때, SD카드의 내용은 초기화 되지 않기 때문에 SD카드의 내용은 수동으로 지워줘야 합니다.
   (저는 PC에 USB로 연결해서 USB 저장소 사용 모드로 전환한 후에 PC상에서 포멧해 버렸습니다.)

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

안드로이드란?

단어 자체의 뜻은 인조인간이다. 사용자를 위해 여러가지 심부름을 대신해준다는 뜻이라고 한다.
 

안드로이드는 누가 만드는가?

안드로이드는 OHA(Open Handset Aliance) 주체로 개발되고 있는 모바일 운영체제이다.
- 명목상 OHA가 개발주체이지만 실직적으로는 구글이 리드하고 있다.
 

안드로이드의 구성 및 특징

커널은 리눅스에 기반한다. 공식적으로 Java를 사용하고, C로 개발할 수 있는 NDK도 발표되었지만 아직 일반적이지는 않다.
안드로이드 내부에는 많은 외부 라이브러리가 포함되어 있어 거의 별도의 외부 라이브러리를 사용할 필요가 없다.
플랫폼에 내장되어 있는 프로그램들과 사용자가 만들어서 탑재하게 되는 프로그램이 동일한 API를 사용하게 되므로, 원한다면 기본 제공되는 프로그램들도 사용자가 원하는 것으로 교체 가능하다. 플랫폼을 구성하는 요소들을 자유롭게 선택할 수 있다는 면에서 유연성이 뛰어나다.
 
 

안드로이드의 아키텍처

 

Application
Framework  Activity 관리자, 윈도우 관리자, 뷰시스템, 패키지 관리자, 전화, 통지, 위치관리자. CP
Library  libc, Media, SQLite, Webkit, OpenGL	Runtime Dalvik Virtual Machine
Linux Kernel  Device Driver, 전원관리, 메모리관리

 
커널위에는 Application들이 공통적으로 사용하는 System library가 존재한다. library 는 장비의 전반적인 속도를 결정하는 중요한 요소여서 Java가 아닌 C로 개발되어 있다.
안드로이드 Runtime은 Dalvik Virtual Machine과 Java Core Library로 구성된다. 안드로이드는 Java Virtual Machine을 직접이용하지 않고 모바일 환경에 최적화된 Dalvik Virtual Machine을 사용한다.
(각 Process별로 별도의 Dalvik Virtual Machine이 할당되는 방식이다.)
Dalvik은 안드로이드 전용 가상머신으로 Java class파일을 직접 실행할 수 없으며 class파일을 dex포맷으로 변환해야 실행가능하다.
 
 

4가지 구성요소

응용프로그램은 아래의 컴포넌트 중 일부만을 가질 수도 있고 여러개를 가질 수도 있다.

• Activity - 사용자 인터페이스를 구성하는 기본단위. 눈에 보이는 화면 하나가 Activity이며 여러개의 View들로 구성된다.
• Service - UI가 없어 사용자의 눈에 직접적으로 보이지 않으며 Background에서 무한히 실행되는 컴포넌트이다.  UI가 없으므로 사용자의 명령을 받아 들일 수 있는 Activity와연결해서 사용한다.
• Brodcast Receiver - 시스템으로부터 전달되는 방송을 대기하고 신호 전달시 수신하는 역할을 한다. 신호만 대기할 뿐 UI를 따로 가지지는 않으므로 방송 수신시 방송의 의미를 해석하고 적절한 Activity를 띄우는 역할을 한다.
• Content Provider - 다른 응용프로그램을 위해 자신의 데이터를 제공한다. 응용프로그램간에 데이터를 공유할 수 있는 합법적인 장치가 Conent Provider이다. ex) Database, 주소록
  

 
 
출처: http://babtingdev.tistory.com/231
 

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

스마트폰이 하나의 생태계를 이루면서 개인 개발자들도 어플리케이션을 만들어서 마켓을 통해서 판매할 수 있게 되었습니다. 그리고 그렇게 해서 많은 수익을 올리는 개발자들이 하나 둘씩 생겨나기 시작했고, 주위에서도 어플 한두개쯤은 올려서 차비 정도는 벌고 있다는 분들도 뵙게 됩니다.
 
유료 어플리케이션을 만들어서 다운로드 수익을 얻는것도 하나의 방법이지만, 무료 어플리케이션을 만들면서 프로그램 안에 광고를 넣고 광고 수익을 얻는 것도 하나의 좋은 수익모델이 될 수 있습니다.
 
한때, 구글 애드센스를 통해서 블로그에 광고를 삽입하고 광고 수익을 얻는 파워블로거들에 대한 이야기가 이슈가 된 적이 있었습니다.
애드센스를 WebView라는 컨트롤을 사용해서 앱 안에 넣는 방법도 가능하지만 구글에서는 원칙적으로 스마트폰용 앱에 개제되는 광고에 대해서는 금지하고 있습니다.
 
여기서는 스마트폰 전용 광고 플렛폼인 Cauly 를 사용해서 프로그램 안에 광고를 넣는 방법을 알아 보겠습니다.
(카올리는 현재 구글 마켓과 SKTelecom의 T-Store만을 지원하고 있습니다.)
 

1. Cauly 사이트를 통하여 인증키 발급받기

스마트폰에 광고를 넣기 위해서는 인증키를 발급 받아야 합니다. 다음의 절차를 통해서 인증키를 발급받을 수 있습니다.
 

1-1. 사이트 접속 후 회원가입, 로그인 진행

카올리 사이트의 주소는 http://www.cauly.net/ 입니다. 이곳에 회원가입과 로그인을 진행합니다.
 
 
 
 

1-2. App 등록 메뉴 이동

상단 메인 메뉴에서 "App 관리"를 클릭하여 페이지를 이동한 후에, 화면 중간쯤의 "App 등록" 버튼을 누릅니다.
 

 

 
 

1-3. 플랫폼 선택 및 이용 약관 동의

화면 중간에서 "Android 플랫폼"을 선택합니다.
스크롤을 아래로 내려서 이용약관 동의에 채크하고 "다음" 버튼을 누릅니다.
 
 
 
 
 
 

1-4. 어플리케이션 정보 입력

어플리케이션의 정보를 입력하는 화면이 나오면, 적절하게 내용을 입력하고 "다음"을 선택합니다.
 
 
 
 
 
 

1-5. SDK 및 메뉴얼 다운로드와 연동키값 확인

등록 절차가 완료되면 SDK와 메뉴얼을 다운로드 받을 수 있는 다음의 화면이 나옵니다.
이 상태에서 스크롤을 아래로 내려보면, 입력한 내용을 확인할 수 있으며, 연동키값을 확인할 수 있습니다.
제 경우에는 연동키 값이 tI3zXBwa3 라고 발급되었습니다.
 
 
 
 
 

2. 안드로이드 프로그램에 광고 적용하기

이제는 개발중인 안드로이드 프로그램안에 광고를 넣을 차례입니다.
광고를 넣기 위해서는 Cauly SDK를 다운로드 받아야 합니다.
SDK를 다운받으면 광고를 보여주는 기능을 하는 라이브러리 (CaulySDK-V1.2.3.jar) 파일과 샘플 소스가 들어 있습니다.
 

2-1. 라이브러리 추가하기

진행 중인 프로젝트에 lib 라는 폴더를 만들고, 그 안에 카울리 라이브러리 파일 (CaulySDK-V1.2.3.jar)을 넣습니다.
 

 
 

2-2. 라이브러리를 프로젝트에 참조시키기 (1)

진행중인 프로젝트를 선택한 상태에서 "Project > Properties" 항목을 선택합니다.
 
 
 
 

2-3. 라이브러리를 프로젝트에 참조시키기 (2)

프로젝트에 대한 Properties 창이 나타나면 왼쪽 트리에서 "Java Build Path" 를 선택합니다.
오른쪽의 메인 화면이 변경되면 "Library" 탭을 선택하고 "Add JARs..." 버튼을 누릅니다.
 
 
 
 

2-4. 라이브러리를 프로젝트에 참조시키기 (3)

"Add Jars..." 버튼을 누르면 "JAR Selection" 이라는 팝업창이 뜹니다. 여기에서 2-1에서 추가해준 카올리 라이브러리를 선택한 후에 "OK"버튼을 누릅니다.
"OK"버튼을 눌러서 창이 닫히면, 그 전에 떠 있던 "Properties"창 역시 "OK"버튼을 누르고 닫습니다.
 

 
 
 
 

2-5. 퍼미션 추가

AndroidManifest.xml 파일을 열어서 다음의 퍼미션들을 추가해 줍니다.

<uses-permission
    android:name="android.permission.CALL_PHONE" />
<uses-permission
    android:name="android.permission.INTERNET" />
<uses-permission
    android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission
    android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission
    android:name="android.permission.READ_EXTERNAL_STORAGE" />

 

2-6. 리소스 파일 처리

res > values > attrs.xml 파일에 대해서 아래의 내용을 추가합니다.
만약 해당 파일이 없을 경우 새로 만들어서 아래의 내용으로 작성해 줍니다.
아래 내용에서 특별히 변경해야 하는 내용은 없습니다.

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <declare-styleable name="com.cauly.android.ad.AdView">
        <attr name="action" format="string" />
        <attr name="appcode" format="string" />
        <attr name="adtype" format="string" />
        <attr name="gender" format="string" />
        <attr name="age" format="string" />
        <attr name="reloadInterval" format="integer" />
        <attr name="effect" format="string" />
        <attr name="allowcall" format="string" />
    </declare-styleable>
</resources>

 
 
 

2-6. XML 레이아웃 편집

광고를 넣기 원하는 XML 페이아웃 파일에 다음의 내용을 추가합니다.
광고를 추가하게 되면 가로 영역에 fill_parent로, 세로영역의 일정 공간을 차지합니다.
아래 내용에서는 두 곳을 수정해야 합니다.
xmlns:app 속성에 들어가는 URL값의 맨 마지막이 자신의 프로젝트 패키지명이 되어야 하며, app:appcode값이 카올리 웹사이트에서 발급받은 연동키 값이 들어가야 합니다.
수정해야 하는 내용과 값은 함께 등록해 놓은 스크린샷을 참조하세요.
추가하는 XML에서 각 Attribute의 의미와 값의 범위는 이 섹션의 맨 아래에 등록한 표를 참조하세요.

<com.cauly.android.ad.AdView
    xmlns:app="http://schemas.android.com/apk/res/자신의_패키지명"
    android:id="@+id/ad"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:layout_alignParentBottom="true"
    android:layout_weight="0"
    app:appcode="발급받은 연동키 값"
    app:adtype="cpc"
    app:gender="all"
    app:age="all"
    app:effect="circle"
    app:allowcall="yes"
    app:reloadInterval="90" />

 
 
 
 
 
 
 
 
 

3. 실행결과 확인과 광고 신청

다음과 같은 실행 결과가 나타나면, 정상적으로 처리가 된 것입니다.
광고가 나타나는 것을 확인했다면, 이제는 마켓에 올리게 됩니다.
카올리 사이트에서 연동키를 발급받으면 최대 1일 정도의 승인 기간이 소요 됩니다.
해당 기간 안에 마켓에 프로그램을 올리면 등록한 어플리케이션 연동키의 상태가 "개제전" 에서 "개제"로 변경되고 그 다음부터 그 광고는 이용자들의 클릭수에 대하여 수익을 얻을 수 있게 됩니다. 
만약 어플리케이션에 광고를 적절치 못하게 넣었거나 카올리의 정책에 위배될 경우 승인 거절이 될 수 있습니다.
승인 거절이 될 수 있는 케이스에 대해서는 SDK와 함께 배포되는 가이드 문서를 참고하세요.
 
  

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

패턴이미지를 LinearLayout 의 background 속성에 적용을 하면 전체화면에 맞게 늘어난다.
원래 크기의 패턴 이미지를 반복해서 백그라운드에 뿌려주고 싶을때 아래와 같이 한다.
 

drawable 폴더에 pattern_bg.xml 파일을 생성한 후 아래 코드를 삽입.

<?xml version="1.0" encoding="utf-8"?>
<bitmap
   android:tileMode="repeat"
   android:src="@drawable/bg_body"
   xmlns:android="http://schemas.android.com/apk/res/android"/>

이제 적용할 곳에 background 속성을 사용하여서 적용한다.  

<LinearLayout
   android:layout_width="fill_parent"
   android:layout_height="wrap_content"
   android:background="@drawable/pattern_bg">  
</LinearLayout>

 

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.

크리에이티브 커먼즈 라이선스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이선스에 따라 이용하실 수 있습니다.