Installasi Vuforia SDK

of 31 /31
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

Embed Size (px)

description

Installasi Vuforia SDK Untuk Aplikasi Augmented Reality

Transcript of Installasi Vuforia SDK

Installasi Vuforia SDK untuk Aplikasi Augmented Reality( Step 1)

Overview :BIla anda android developer dansudah menginstal SDK dan NDK Android, maka silakanlangsung 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 X1. 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 / eclipse.ini baris berikut di bagian atas:-vm Contoh:-vm / user / bin / java

1. 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 akanmenggunakan istilah dimana asumsi dari development_roo disini adalah :

C: \ Developer \ Android ( ATAU FOLDER MANAPUN YANG ANDA INGINKAN ).

Namun pada tutorial ini akan menggunaan istilah tersebutuntuk 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 adalahbukansepenuhnya environment SDK. Ini hanya mencakupcore SDK tools, yang dapat digunakan untuk men-download seluruh paket SDK(misalnya seperti system image).

Persiapan pada WindowsPaket 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 pengaturanSystem Advanceduntuk 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: Quick Start Android SDK 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

1. Eclipse CDTSebelum 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 yangsudah 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 andatidak 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

1. ADTAndroid 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 danmenerima sertifikat .Restart,

~~~ Instalasi ADT Android selesai ~~

1. Android SDK PlatformUntuk 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 sebagaishared libraryuntuk 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 mengubahroot directorydi jendela berikutnya, dan memebuiarkannya tetap di "C: \ cygwin". "Local Package Directory" menanganidownload 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 Androidmembangunperformance-critical partsdari aplikasi dalam native code.0. Download package NDK dari :http://developer.android.com/sdk/ndk/index.html0. 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!

0. Untuk melakukan hal itu (menambhakan path NDK pada windows) : klik kanan pada 'My Computer' dan pilihproperties.

0.

Lalu plih ..

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

DownloadVuforia 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 :DownloadsSDK and Release NotesPlatformPackageLast Updated

Windowsvuforia-sdk-android-1-5-9.exe22-Feb-2012

Macvuforia-sdk-android-1-5-9.zip22-Feb-2012

Linuxvuforia-sdk-android-1-5-9.bin22-Feb-2012

SDK Release Notesrelease-notes-1-5-9.pdf22-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 "EnvironmentVariable"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 (atau sesuai settingan folder anda pada tahap installasi sebelumnya).Kemudian yang dilakukan adalah setting "environmentvariable", 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 DevicePengaturan 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 USBPada 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:

\ 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 3Compile & 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 danfiturpelacakan environtment dengan menggunakan gambar yang sama. Bagian ini akan menunjukkan kepada Anda bagaimana mem-build native source codeC ++ dengan paket NDK dari SDK Android dan kemudian menggunakan Eclipse untuk mem-buildsource 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 deploymelalui 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 " \ 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 aplikasiDengan 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.