[1] Getting Started with the Facebook SDK for Android

Getting Started with the Facebook SDK for Android

원문 링크 : https://developers.facebook.com/docs/getting-started/facebook-sdk-for-android/3.0/

Getting Started 는 개발전, 사전 준비단계라고 할 수 있습니다.

따지고 보면 전체 개발에 포함되는 내용이긴 하지만, 코딩은 아닌, 코딩 이전에 준비되어 있어야 하는 것들입니다.

아래서 나오긴 하지만, 안드로이드를 코딩하기 위해, Android SDK 를 다운로드 받고, ADT 플러그인 설치하고, 페이스북 SDK 를 받고 하는 것들과 기본적인 library project 설정에 관련된 것들이 나옵니다.

---

한번 주욱 훑어보니...

이럴수가! Getting start! 를 위한 동영상까지 있습니다.

https://www.facebook.com/photo.php?v=10151565121324838

원래 이렇게 친절한 형들이 아니었는데 무슨일일까요. 어쨋든 동영상도 있으니 좋네요.

동영상에 나오는 개발자분(목소리만 나옵니다.)이... 인도쪽분일까요 발음이 조금 쎈듯한 느낌이 있네요.

---

The Facebook SDK for Android 는 페이스북 플랫폼과 안드로이드 앱을 통합하는 가장 쉬운 방법입니다.

SDK 는 페이스북 인증 로그인, Facebook API 로 읽기(reading)와 쓰기(writing)에 대한 지원을 제공합니다. 뿐만 아니라 UI 요소로서의 picker 와 dialog 를 지원합니다.

Facebook SDK for Android 로 개발을 시작하기 위해서, 아래의 스텝들을 따르십시오. 이 가이드의 스크린샷이 Apple OS X 환경이긴 하지만, Windows machine 에서도 이 스텝들은  거의 동일하고, 다른 부분들은 지침에 강조표시가 되어있습니다.

---

1. Install the Prequisites  You need Eclipse, the Android SDK, and the ADT plugin

이클립스를 설치하고, 안드로이드 SDK 를 설치하고 ADT 플러그인을 설치하는 것들에 대한 내용입니다.

요건.. pass...

---

2. Install the Facebook SDK for Android and the Facebook APK  Download and extract the installation package. Install the Facebook app to your emulator

SDK ZIP file 을 다운로드 받습니다.

압축을 풀면, facebook-android-sdk-3.0 디렉토리가 있을거에요.

디렉토리를 살펴보면... 이렇게 구성이 되어있네요.

/facebook-android-sdk-3.0/bin

- 이곳 Step 2 에서 Install 할 FBAndroid-2.0.apk 가 포함되어있습니다. 

(이뮬레이터로 테스트할때 쓰라고 같이 넣어준 페이스북 앱입니다.)

/facebook-android-sdk-3.0/docs

- Facebook SDK 의 Class, contant value, overview 등 여러 document 들이 포함되어있습니다. 

/facebook-android-sdk-3.0/facebook

- 이 디렉토리가 실제 SDK 프로젝트입니다. 실제 사용할때는 library project 로 포함시켜 사용합니다.

/facebook-android-sdk-3.0/samples

- 샘플들이 있습니다. 예전(2.0) 버전에서는 3-4개 정도였던 샘플들이 10개로 늘어있군요. 레퍼런스가 많아져서 좋네요.

우선 페이스북 레퍼런스 형들이 시키는 데로 이뮬레이터에 페이스북 앱을 인스톨 해봅니다.

console 에서 adb 를 통해 이뮬레이터에 apk 를 인스톨할수있죠. 

./adb install ~/facebook-android-sdk-3.0/bin/FBAndroid-2.0.apk

위 예시처럼 ~~~/sdk/platform-tools 디렉토리에서 adb 를 실행하면 별문제 없이 잘 될텐데, 아무데서나 실행하지는 못하죠. 임의의 디렉토리에서 실행하려고 할때 adb 명령을 실행할 수 없다고 나오면...

.bash_profile(~/.bash_profile) 파일에 아래와 같은 라인을 추가해줍니다.

PATH=$PATH:/SDK경로.../sdk/platform-tools

// in ~/.bash_profile. 제 컴퓨터에서의 경로로 적으면.. 이렇게 됩니다.
PATH=$PATH:/Users/croute/develop/adt-bundle-mac-x86_64/sdk/platform-tools 

// 수정을 완료했으면... source 명령으로 적용시켜줍니다.
$ source ~/.bash_profile

Windows 환경에서는 이렇게 실행하면 됩니다. 

adb install %HOMEPATH%\facebook-android-sdk-3.0\bin\FBAndroid-2.0.apk

한번 인스톨을 하고 난 이후, 같은 apk 로 다시 인스톨 하려고 할때,,, 이런 에러를 내뱉기도 합니다. 
Failure [INSTALL_FAILED_ALREADY_EXISTS]

이럴때는 -r 옵션을 이용해서 reinstall 해줍니다. 이때 reinstall(-r) 을 해도 기존 데이터는 보존됩니다.

./adb install -r ~/facebook-android-sdk-3.0/bin/FBAndroid-2.0.apk

adb 명령에 대한 정보는 -help 옵션을 통해 자세히 볼 수 있습니다.

./adb -help

이뮬레이터를 실행시키고 위 명령을 통해서 설치를 정상적으로 마쳤다면, 이뮬레이터에서 아래 스크린샷처럼 제대로 설치되어있는 페이스북 앱을 볼 수 있습니다.  

(Getting started 스크린샷에서는 홈화면에 아이콘이 꺼내지는것처럼 해놨는데 그렇진 않으니...)

사실... 안드로이드는 거의 실제 디바이스가지고 개발하니까 그냥 마켓에서 다운받아서 쓰면 되긴하죠... 쿨럭...

---

3. Import the SDK into Eclipse  Add the SDK as a library project to your workspace, along with the sample projects

다운로드 받은 디렉토리를 보면, facebook(Facebook SDK project) 디렉토리와 samples  디렉토리가 있습니다.

이제 이 프로젝트들을 하나의 workspace 에 import 합니다.

(기존 페이스북 프로젝트가 있는지 확인하고 삭제하고.. 이런얘기가 좀 있는데, 그냥 새기분으로 하는걸로.)

이제 SDK 와 샘플 프로젝트를 import 할건데요.

이클립스 메뉴의 [File] > [Import] 를 선택합니다.

그리고 [General] > [Existing Projects into Workspace] 를 선택합니다.

SDK 디렉토리의 root 를 선택해줍니다. 디폴트로 압축을 해제 했으면, facebook-android-sdk-3.0 디렉토리일거에요. 

선택하면 샘플 프로젝트들, SDK 프로젝트가 프로젝트 리스트에 들어오게됩니다.

[Copy projects into workspace] 옵션은 체크를 해제해줍니다.

(기존 샘플들이 가지고 있는 reference를 정확하게 유지해야하거든요.

추가적으로 디테일한 설명들이 더 있는데 중요하진 않으니 pass 를...)

[Finish] 를 눌러 프로젝트 import 를 마치고, 이클립스의 프로젝트들을 clean 해줍니다.

클린 후에도 에러가 나면 여러가지 방법을 사용해 볼 수 있습니다. 자세한건 [더보기]를 통해서 보셔요.

Project properties 를 보면 Java compiler 에서 Complier compliance level 을 변경할 수 있습니다.

1.6 으로 변경해줍니다.

혹시, Text file encoding 이 EUC-KR 로 되어있을 수 있습니다.

UTF-8 로 변경해줍니다.

그래도 안된다면... Library Project(Facebook SDK Project) 의 reference 를 끊었다가 다시 연결해줍니다.

이제 샘플 앱들을 실행 시킬 준비가 된거구요. 앱들을 실행 시키는건 다음 단계에서~