Installasi Vuforia SDK untuk

Aplikasi Augmented
Reality ( Step 1)
Overview :
BIla anda android developer dan sudah menginstal SDK dan NDK
Android, maka silakan langsung menuju ke Step 2. Jika Anda pemula
dalam dunia Android atau hanya memiliki installasi SDK android belum
menginstall NDK maka Anda akan disarankan untuk memulai step 1 di
bawah ini.
Untuk dapat menjalankan vuforia SDK pada project android anda,
setidaknya berikut ini adalah langkah-langkah yang kemudian saya bagi
dalam beberapa part;
1. Pengaturan Development Environment
- JDK
- Eclipse IDE
- Android SDK
- Eclipse CDT
- Android ADT
- Android SDK Platform
- Cygwin Environtment
- Android NDK
Setelah step 1, maka anda melanjutkan ke Step 2 dan 3. Yang akan
dilakukan pada step 2 dan 3 adalah sebagai berikut.
2. Instalasi SDK Vuforia
- Install Vuforia SDk
- Set Q-car Variabel
- Persiapan Device
3. Compile & Menjalankan App Contoh Vuforia

Preview setelah Run :

Pengaturan Development
Environment (Step-1)
1

JDK
- Download Java SE Development Kit (JDK) dari situs berikut ini:
http://www.oracle.com/technetwork/java/javase/downloads/
- Klik 'Download' tombol dari bagian JDK dari 'Java Platform, Standard
Edition' .
- Instal JDK Environtment dengan pengaturan standar.
Petunjuk instalasi rinci dan persyaratan sistem dapat ditemukan di:
http://www.oracle.com/technetwork/java/javase/index137561.html
MAC: The JDK sudah diintegrasikan ke dalam sistem operasi Mac OS X

IDE
Dalam langkah ini Anda akan menginstal IDE Eclipse. Download versi
terbaru dari Eclipse IDE untuk Java Developers:
http://www.eclipse.org/downloads/
NOTE : Pada tutorial ini ditest menggunakan Eclipse indigo SR2. Setelah mendownload,
ekstrak file zip nya lalu letekan di folder yang anda inginkan. Atau langsung jalankan
eclipse langsung dari folder yang telah di ekstrak sebelumnya.

Start eclipse.exe
Pertama kali Eclipse dijalankan, eclipse akan meminta Anda untuk

menetapkan ruang penyimpanan (works space) untuk ruang kerja Anda,

ubah sesuai keinginan anda atau biarkan lalu klik ok.

Direktori workspace ini akan berisi pengaturan spesifik dan informasi

hanya mengenai IDE. Jenis informasi yang biasanya disimpan di direktori
home user. Ceklist "Use this as the default and do not ask again" jika
anda tidak menginginkan pop up tersebut muncul setiap memulai eclipse.
NOTE :
MAC: Untuk Mac OS X kami menyarankan Anda menggunakan versi 32-bit dari
Eclipse.LINUX: Eclipse tidak selalu dapat menentukan lokasi JVM, meskipun di jalan,
Untuk mengatasinya, masukkan ke <path-to-eclipse-dir> / eclipse.ini baris berikut di
bagian atas:-vm <path-to-JVM>Contoh:-vm / user / bin / java

Android SDK
Android didistribusikan melalui starter package berisi SDK Tools.
3.1 Download SDK :
http://developer.android.com/sdk/index.html
3.2 Unzip File dan salin isinya ke Contoh : direktori. C:\Developer\
Android\ android-sdk-windows\.
Selama tutuorial ini mungkin akan menggunakan
istilah <DEVELOPMENT_ROOT> dimana asumsi dari
development_roo disini adalah :
C: \ Developer \ Android ( ATAU FOLDER MANAPUN YANG ANDA
INGINKAN ).
Namun pada tutorial ini akan menggunaan istilah tersebut untuk
memudahkan penyebutan saja.
NOTE: Jangan gunakan nama path dengan spasi.
Sekarang anda telah mendownload SDK Android. Sekarang Anda perlu
mengatur development environment untuk aplikasi Anda.- SDK yang telah
Anda download adalah bukan sepenuhnya environment SDK. Ini hanya
mencakup core SDK tools, yang dapat digunakan untuk men-download
seluruh paket SDK(misalnya seperti system image).

Persiapan pada Windows

Paket download Anda adalah file executable dari installer. Installer
memeriksa mesin Anda untuk peralatan yang diperlukan, seperti Java SE
yang tepat Development Kit (JDK) dan menginstalnya jika perlu. Installer
kemudian menyimpan Android SDK ke lokasi default (atau Anda dapat
menentukan lokasi). Namun tidak melakukan setting pada windows anda,
maka anda perlu melakukan setting variable pada windows anda, berikut
adalah langkah-langkah yang harus anda lakukan.
Setting Path Variables Windows

Klik kanan pada Computer yang pada menu windows dan select
Properties.

Lalu pilih pengaturan System Advanced untuk membuka jendela

System Properties

dan pilih Environments Variabel pada tab Advanced.

Carilah path variabel di System variabel.

Setelah menekan Edit, select ke nilai Variable yang paling ujung
atau terkahir pada path variable anda

Tambahkan alamat path baru, tambahkan titik koma untuk

memisahkan dari path yang sebelumnya.
Sebagai contoh:
C: \ Developer \ Android \ android-sdk-windows \ tools \

CATATAN: "\" terakhir di akhir variabel Path harus

disertakan.Instalasi ADT android pada langkah berikutnya akan
menggunakan path ini untuk mengidentifikasi development
environment Android. TroubleshootingUntuk mengatasi masalah

Android terkait dan untuk petunjuk lebih rinci mengenai SDK Android,
silakan kunjungin beberapa situs berikut:
o
Quick Start Android SDK
o
Installing the Android SDK.
NOTE :MAC: Update PATH variabel untuk menunjuk ke utilitas 'make' dan
Android SDK direktori alat di rc.common / etc / atau ~ / bash_profile
file.:PATH=/bin:/sbin:/usr/bin:/usr/sbin:/usr/libexec:/System/Library/CoreSe
rvices:/Developer/usr/bin:~/Development/Android/android-sdkmacosx/tools;export PATHLINUX: Perbarui PATH Anda untuk menunjuk ke
utilitas 'make' dan Android SDK direktori alat. Jika Anda menggunakan bash
shell menambahkan berikut ke ~ / bashrc.:export PATH = / opt / androidsdk-linux / tools /: $ PATH

Eclipse CDT
Sebelum Menginstall ADT android (versi 20 keatas ) disarankan
untuk menginstall CDT terlebih dahulu karena nantinya ADT20 akan
menginstall NDK plugin pada eclipse yang membutuhkan CDT.
( Berdasarkan pengalaman pribadi).
Lalu apakah CDT?
Pada dasarnya CDT menyediakan fungsional penuh C dan C + +
Integrated Development Environment berbasis pada platform Eclipse.
Fiturnya antara lain: dukungan untuk pembuatan proyek dan pengelolaan
dibangun untuk toolchains berbagai standar membuat membangun,
navigasi sumber, alat berbagai sumber pengetahuan, seperti jenis hirarki,
call graph, termasuk browser, browser makro definisi, editor kode dengan
sintaks, lipat dan hyperlink navigasi, source code refactoring dan
pembuatan kode, alat debugging visual, termasuk memori, register,
viewers disassembly.
Terlabih dahulu disarankan untuk mendownload CDT , Download
CDT : http://www.eclipse.org/cdt/downloads.php
Install CDT pada Eclipse :- Pilih Help-> Install New Software -> Click

Add

- Masukan Name " CDT " -> lalu pilih archive -> pilih CDT.zip
yang sudah didownload sebelumnya -> lalu OK

- Kemudian ceklist seperti gambar berikut

dua diataranya tidak di ceklist karena adanya error, namun tetap bisa
menginstall NDK pada tahap berikutnya.
- Selanjutnya cukup mengikuti prosedur pengistalan seperti accept
agreement dsb hingga anda diminta untuk merestart eclipse.
NOTE : Jika terjadi stuck pada saat waiting dependencies pastikan
anda tidak mengceklist "Contact All Updates Site.. " .
Setelah anda menginstall CDT ini anda akan siap untuk mengistall ADT
versi 20 yang menyediakan opsi instalasi NDK pada eclipse

ADT Android Development Tools

ADT adalah ekstensi ampuh untuk Eclipse yang menjadi penghubung
SDK Android dan membantu dalam pengembangan aplikasi. Paket ini

diinstal dari Eclipse.

Pilih Help-> Install New Software

Click Add -> Lalu Tambahkan url

https://dl-ssl.google.com/android/eclipse/
Atau bisa download .zip terbarunya nya, lalu klik archive ->
lalu pilih lokasi adt.zip yang telah anda pilihjangan Lupa untuk
memasukan nama " ADT Plugin"

Setelah beberapa saat Developer Tools muncul field.

Select All
lalu klik Next->.
Setelah meninjau pemilihan ini dan menerima persyaratan lisensi
lalu, mendownload file dan menerima sertifikat .Restart,
~~~ Instalasi ADT Android selesai

~~

Android SDK Platform

Untuk pengembangan Android, dukungan untuk platform Android yang
sesuai harus diinstal. Android SDK Manager digunakan untuk menginstal
komponen tambahan dan dukungan untuk berbagai platform.
Pilih pada Eclipse menu Window-> Android SDK Manager.

Dalam Android SDK lokasi tidak diatur dengan benar dalam Eclipse,
Masuk ke Windows-> Preferences-> Android dan set field lokasi SDK
untuk root direktori instalasi SDK Anda.
1

Cygwin
LINUX: Pada sesi ini tidak relevan bagi pengguna Linux yang memiliki
GNU yang telah terpasang dan di pathnya.
MAC: Pada sesi ini tidak relevan bagi pengguna Mac yang memiliki Apple
Developer Tools (Xcode) yang telah terinstal. jika diperlukan Instal Xcode
dari http://developer.apple.com/xcode/.
Sebuah kompiler GNU diperlukan untuk mengcompile aplikasi dinamis
sebagai shared library untuk NDK Android, dimana Android membuat
yang file didesain untuk dijalankan dengan gcc4. Pada Windows, cara
mudah untuk memiliki lingkungan yang lengkap siap pakai untuk ini,
adalah dengan menginstal Cygwin.
Cygwin menggunakan installer pembantu untuk mengelola proses
instalasi.

Kunjungi - http :/ / www.cygwin.com / setup.exe dan pilih "Install

from the Internet!" saat diperintahkan di "Pilih Sumber Download" di
installer. Kami merekomendasikan tidak mengubah root directory di
jendela berikutnya, dan memebuiarkannya tetap di "C: \ cygwin".
"Local Package Directory" menangani download pakckage. Anda
mungkin ingin membiarkan mereka dengan Setup.exe download di
direktori yang sama sehingga memiliki direktori installer Cygwin.
Lalu pilih situs download dengan koneksi yang terbaik menurut
anda.

Ketika informasi paket-download Anda akan melihat browser hirarki

untuk memilih paket. Pilih paket berikut dari hirarki untuk download:
Semua -> Devel -> "membuat: Versi GNU dari utilitas 'membuat'"
Pilih kata "loncat" untuk mengubahnya ke nomor versi yang
sebenarnya, yang saat ini 3,81-2. Selesai instalasi dengan mengklik
berikutnya.
Anda Cygwin lingkungan sepenuhnya set-up untuk bekerja dengan
SDK QCAR. Jika Anda memiliki lingkungan lain yang serupa diinstal,
pastikan untuk mengatur Anda variabel path Windows untuk
menunjuk ke "C: \ cygwin \ bin" sehingga pesta ini menggunakan
versi make.exe GNU.
1

Android NDK
NDK Android adalah ekstensi untuk SDK Android yang memungkinkan
pengembang Android membangun performance-critical parts dari aplikasi
dalam native code.

Download package NDK dari :

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

Unzip arsip dan copy isinya ke dalam sebuah direktori.

Agar konsisten dengan setup saya yang sebelumnya, saya sarankan
Anda meletakkan isi "C: \ Developer \ Android \ android-NDKr7 \". Jadi Android SDK dan NDK Android berbagi direktori root yang
sama (C:Developer\Android\ ...) .
NDK memerlukan direktori di atas untuk ditambahkan ke path
Windows!

Untuk melakukan hal itu (menambhakan path NDK pada

windows) : klik kanan pada 'My Computer' dan pilih properties.

Lalu plih ..

Pada 'Advanced' tab 'Environment Variable ' pilih dan

cari Variabel 'Path' di jendela 'System Variable'.

Setelah kilik 'Edit', arahkan ke 'Variable Value' yang paling

terakhir dan tambahkan path lengkap ke direktori ,pisahkan melalui
titik koma dari yang sebelumnya. Dalam contoh di atas, Anda harus
menambahkan:
C: \ Pembangunan \ Android \ android-NDK-r7 \

NOTE: Path memiliki titik koma di awal. Jangan gunakan nama path dengan
spasi. Atau, Anda juga dapat menetapkan variabel Pengguna dengan nama Jalan,
tapi ini hanya berlaku untuk pengguna saat ini. The "\" terakhir di akhir variabel
Path harus disertakan.

Test Instalasi NDK

Pada bagian ini akan menguji apakah instalasi NDK telah berhasil.
Untuk menguji instalasi Anda dapat compile salah satu contoh
aplikasi NDK.
- Menggunakan Cygwin bash shell atau cmd , arahkan ke direktori
root dari aplikasi demo (misalnya untuk aplikasi sampel 'san-angeles'
dengan jalur instalasi di atas):

- cd / cygdrive/c/Development/Android/android-ndk-r7/samples/sanangeles
- Lalu ketik -> NDK-build

- Compiler seharusnya menghasilkan library libsanangeles.so

terkait secara dinamis dan menulis ke / libs / armeabi dalam direktori
aplikasi. NDK mencakup dukungan untuk arsitektur yang berbeda
jadi Anda dapat menemukan subdirektori berbeda dalam / libs.
Sekarang Development Environtment Anda siap untuk
menjadi 'rumah Vuforia SDK".

Installasi vuforia SDK (Step-2)

Ini merupaka step dari tutorial sebelumnya diaman akan melakukan
installasi Vuforia SDK. Vuforia SDK didistribusikan menggunakan installer
untuk platform seperti: Windows, Mac OS X, dan Linux.
pada step 2 ini yang akan dilakukan:
- Install Vuforia SDK
- Set Qcar Variabel
- Persiapan Device
Untuk mulai berkembang dengan SDK Vuforia Anda akan perlu,
Download & Install Vuforia SDK bawah <DEVELOPMENT_ROOT>.
Sesuaikan pengaturan Lingkungan Vuforia di Eclipse.
Setelah "accept agreement" installer membuat struktur direktori dalam
development environment Android. Struktur ini akan memastikan bahwa
aplikasi sampel dapat dengan mudah dibangun dan disebarkan
menggunakan NDK Android dan Eclipse Java developer environment..

Instal SDK Vuforia

Download
Vuforia SDK didistribusikan melalui situs Augmented Reality Qualcomm
Developer Platform. Ikuti petunjuk di bawah untuk mengakses installer.
NOTE: Meskipun kami mendistribusikan installer untuk platform
tercantum di bawah ini, dukungan untuk Vuforia SDK pengembangan
terbatas pada platform 7 32/64-bit Win.
Window
Meskipun kami menyarankan Anda mengembangkan di Windows 7 atau
Windows XP 32/64-bit 32-bit , SDK Vuforia juga telah berhasil dijalankan
pada Windows XP 64-bit. Namun, saat ini vuforia sendiri tidak
menawarkan dukungan khusus untuk platform ini.
Unduh installer EXE-file dari :
Downloads

SDK and Release Notes

Platform

Package

Last Updated

Windows

vuforia-sdk-android-1-5-9.exe

22-Feb-2012

Mac

vuforia-sdk-android-1-5-9.zip

22-Feb-2012

Linux

vuforia-sdk-android-1-5-9.bin

22-Feb-2012

SDK Release Notes

release-notes-1-5-9.pdf

22-Feb-2012

Jalankan installer
Mac OS X
Instalasi telah diuji pada Mac OS X 10.6 dan OS X 10.7.
Download file arsip dari halaman Downloads.
Mengurai dan menjalankan installer
Linux
Instalasi telah diuji pada Ubuntu 11.10.
Memerlukan JVM yang akan diinstal
Download file installer dari halaman Downloads.
Buka jendela terminal dan mengubah direktori ke lokasi file installer
Mengubah modus installer yang akan dieksekusi
Jalankan file installer pada baris perintah

Mengatur "Environment Variable" QCAR

Struktur direktori yang direkomendasikan kami memungkinkan untuk
upgrade SDK independen pengembangan aplikasi. Nantinya proyek AR
anda akan berada dalam struktur yang direkomendasikan di bawah
<DEVELOPMENT_ROOT> (atau sesuai settingan folder anda pada tahap
installasi sebelumnya).Kemudian yang dilakukan adalah setting
"environment variable", untuk melakukan nya:
Pada Eclipse, pergi ke Window-> Preferences.

Arahkan ke Java-> Build Path-> Variable Classpath

Pilih New - > masukan nama variable :

QCAR_SDK_ROOT
C :/ Development / Android / vuforia-sdk-android-xx-yy-zz
xx-yy-zz menunjukkan jumlah Vuforia versi saat ini SDK.

Pengaturan ini penting karena pengaturan classpath dalam file sampel

menggunakan referensi ini untuk menyertakan file JAR bersama.
MAC: Menu preferensi pada Mac OS X berada di bawah Eclipse->
Preferences.

Memperisapkan Device
Pengaturan pada Perangkat
Perangkat Android memerlukan pengaturan khusus untuk pengembaangan.
Dalam langkah ini kita akan :

Memungkinkan aplikasi yang akan diinstal dari sumber yang tidak

diketahui

Aktifkan debugging USB

Pada perangkat, pergi ke Settings-> Applications dan pilih "Unknown sources"

seperti yang ditunjukkan di bawah ini. Terima peringatan ditampilkan di sebelah
kanan. Pengaturan ini memungkinkan instalasi langsung APK unsigned dari
dalam Eclipse.

( Membiarkan sumber yang tidak diketahui untuk instalasi software )

Buka Development dialog pada layar atas dan memilih dua pengaturan seperti yang
ditunjukkan di bawah ini:
USB debugging adalah wajib. Pengaturan tinggal terjaga akan membantu
dengan pembangunan.
Instal Driver USB
Hubungkan perangkat Anda ke PC pembangunan melalui kabel USB.
Pada sambungan awal, Windows akan mengenali perangkat baru dan mencoba
untuk mencari driver yang kompatibel. SDK Android sudah termasuk beberapa
driver USB - lain harus diperoleh langsung dari produsen perangkat. SDK prapaket driver dapat ditemukan di direktori berikut:
<DEVELOPMENT_ROOT> \ Android-sdk-windows \ ekstra \ google \ usb_driver
Saat instalasi perangkat selesai Anda siap untuk menggunakan perangkat
pengujian Anda.
Pada beberapa mesin instalasi driver USB akan meminta Anda untuk reboot
komputer. Anda dapat melewatkan langkah ini dan perangkat harus dapat
diakses tanpa reboot.
CATATAN: Anda harus menghubungi produsen perangkat anda untuk
memastikan bahwa Anda menggunakan driver USB yang benar.

STEP 3
Compile & Menjalankan App Contoh Vuforia
Sekarang kita akan mem-build sebuah aplikasi sampel yang disertakan
dalam paket SDK Vuforia. Aplikasi ImageTargets adalah sample yang baik
untuk mulai belajar tentang SDK karena menunjukkan deteksi
dan fitur pelacakan environtment dengan menggunakan gambar yang
sama. Bagian ini akan menunjukkan kepada Anda bagaimana mem-build
native source code C ++ dengan paket NDK dari SDK Android dan
kemudian menggunakan Eclipse untuk mem-build source code java dan
membuat paket APK yang dapat digunakan untuk di install
padaperangkat mobile.
Compile the Shared Object
Compile the Shared Object dengan Application Code.
Android NDK aplikasi ditempatkan sebagai objek bersama dengan
bootloader Java. Pada tahap ini kita akan mem-build binary *.so file
yang nantinya dikemas dalam Eclipse.
Untuk setiap aplikasi anda akan perlu untuk mem-build .so
aplikasi SECARA TERPISAH.

Untuk Melakukan itu dapat dilakukan dengan cmd,

- Buka cmd lalu arahkan ke DEVELOPMENT ROOT \vuforia-sdk-androidxx-yy-zz\samples

- Lalu Eksekusi -> "ndk-build" pada direktori sampel project Vuforia

anda.

Jika berhasil seperti tampilan diatas berarti aplikasi sampel dari Vuforia
SDK telah siap di deploy melalui eclipse ke devices.
NOTE : Tahap Harus dilakaukan sebelum anda menjalankan aplikasi di
eclipse untuk dites ke device ( hp/tablet).

Jalankan Aplikasi Contoh

Cetak Target Gambar
Cetak semua PDF sasaran gambar di " <DEVELOPMENT_ROOT> \
vuforia-sdk-android-xx-yy-zz \ sampel \ ImageTargets \ media " ke kertas
berukuran A4 dengan opsi 'none' scaling page, untuk menjaga rasio asli
aspek gambar tetap utuh.

"Chips" Gambar Sasaran "batu" Gambar Sasaran

"Aspal" Gambar Sasaran

Deploy & Jalankan Aplikasi Contoh

Import samples di Eclipse
- Klik kanan pada Package Explorer -> klik import

- Pilih existing android app- > lalu Next

- Lalu pada ImportProject window, pilih alamat sample project Vuforia

berada yang bersamaan dengan QCAR atau lokasi anda mengistall
Vuforia SDK -> lalu klik Finish.

- Kini Project siap di run

- Sebelum Project di run Cek kembali BuildVariable dari project yang

hendak anda run. Click kanan pada folder ImageTargets ( Contoh ) ->
build Path -> Configure Build Path

- Pastikan Qcar Variable berada ditempatnya dengan setting terceklist.

Jike semua telah okeh maka langkah selanjutnya adalah run

aplikasi Dengan perangkat terhubung,
Pilih "ImageTargets" proyek (contoh )dari Explorer Paket di Eclipse dan
pilih Run-> Run As-> Android Application.

Eclipse secara otomatis menginstalnya ke perangkat Android terhubung

menggunakan ADB, dan mulai menjalankannya pada perangkat.
Sekarang ketika Anda memegang perangkat Anda melawan target dicetak
"chip", Anda akan melihat gambar berikut:

Anda telah berhasil menjalankan aplikasi pertama Anda dengan

SDK Vuforia!
Setelah splash screen gambar kamera secara langsung ditampilkan.
Gunakan perangkat Anda untuk melihat target dicetak. Anda akan melihat
teko bertekstur berpusat di atas target, didaftarkan ke pesawat.
Selanjutnya, tekan tombol menu, lalu pilih "Switch to Tarmac dataset",
dan kemudian pegang perangkat Anda melawan "tarmac" target dicetak
dan Anda akan melihat teko, hanya sekarang itu adalah oranye.
App ImageTargets menunjukkan bagaimana SDK dapat mendeteksi dan
melacak satu gambar dari set yang telah ditentukan gambar. Aplikasi ini
juga menunjukkan bagaimana untuk beralih di antara dataset tanpa
terlalu banyak usaha, serta bagaimana menangani pengaturan kamera,
seperti autofocus. Dengan perubahan kode kecil, juga dapat dikompilasi
untuk mendeteksi dan melacak beberapa gambar secara bersamaan.
Periksa Tips & Trik bagian dalam Panduan Pengembang untuk informasi
lebih lanjut tentang ini.
Troubelshoot
Jika Anda mengalami masalah pada instalasi, periksa pengaturan
sambungan perangkat dalam Device Uji Siapkan untuk Pembangunan.
Dalam Eclipse, Anda dapat melihat apakah perangkat terhubung dengan
benar melalui ADB di panel DDMS (Jendela-> Perspektif-> Buka DDMS).
Perangkat harus terdaftar di bawah 'Devices'.
Atau, membuka Cygwin bash shell dan jalankan

adb devices
Outputnya harus menunjukkan perangkat yang terpasang:
$ Adb evices
Daftar perangkat terpasang
HT012P123456 perangkat
Jika daftar perangkat kosong, atau perangkat yang diberikan tidak
terdaftar, membunuh server ADB dengan mengeksekusi
adb kill-server
Pelaksanan 'perangkat adb' lagi akan me-restart server dan remendeteksi perangkat.