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/index-137561.htmlMAC: The JDK sudah diintegrasikan ke dalam sistem operasi Mac OS X

2. IDEDalam 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.exePertama 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 

3. Android SDK

Android didistribusikan melalui starter package berisi SDK Tools.

3.1 Download SDK :

http://developer.android.com/sdk/index.html3.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/CoreServices:/Developer/usr/bin:~/Development/Android/android-sdk-macosx/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 / android-sdk-linux / tools /: $ PATH

4. 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.phpInstall 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

 5. 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    ~~

6. 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.

7. 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. 

8. 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-NDK-r7 \". 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 NDKPada 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/san-angeles

- 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.

WindowMeskipun 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 XInstalasi telah diuji pada Mac OS X 10.6 dan OS X 10.7.

Download file arsip dari halaman Downloads.Mengurai dan menjalankan installerLinuxInstalasi telah diuji pada Ubuntu 11.10.

Memerlukan JVM yang akan diinstalDownload file installer dari halaman Downloads.Buka jendela terminal dan mengubah direktori ke lokasi file installerMengubah modus installer yang akan dieksekusiJalankan 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 PerangkatPerangkat 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 USBHubungkan 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 pra-paket 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-android-xx-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.

TroubelshootJika 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 devicesOutputnya harus menunjukkan perangkat yang terpasang:

$ Adb evices

Daftar perangkat terpasangHT012P123456 perangkatJika daftar perangkat kosong, atau perangkat yang diberikan tidak terdaftar, membunuh server ADB dengan mengeksekusi

adb kill-serverPelaksanan 'perangkat adb' lagi akan me-restart server dan re-mendeteksi perangkat.