You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 4_Android/android_native.md
+17-20Lines changed: 17 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,23 +6,21 @@ Building native ARToolKit libraries requires a development environment capable o
6
6
7
7
*Note: This is by no means a comprehensive guide on how to setup an NDK development environment. If you need assistance in this area, please search online as there are many tutorials and articles covering this topic and it is outside the scope of this user guide.*
8
8
9
-
> Deprecated development tools and methods:<br/>
10
-
> Eclipse IDE<br/>
11
-
> ADT Plugin for Eclipse<br/>
12
-
> Android NDK plugin for Eclipse<br/>
13
-
> Cygwin<br/>
9
+
> Deprecated development tools and methods:
10
+
>
11
+
> - Eclipse IDE
12
+
> - ADT Plugin for Eclipse
13
+
> - Android NDK plugin for Eclipse
14
+
> - Cygwin
14
15
15
16
The following SDKs and tools should be installed and configured correctly on one of the chosen supported development systems.
16
17
17
18
#####These are required for standard Android JDK development:
18
19
19
20
-[Standard Edition Java Development Kit][1] 1.7 or greater
20
-
-[Android SDK][2]
21
-
<pstyle="margin-left: 2em;">Downloaded with Android Studio IDE to</p>
-[Android SDK][2] (Downloaded with Android Studio IDE)
22
+
- for Mac OS X: default install path: *"/Users/<user>/Library/Android/sdk"*
23
+
- for Windows Desktop: recommended install path: *"C:\Users\\<user>\\Android\\sdk"*
26
24
-[Android Studio IDE][3] - version 1.5.x
27
25
28
26
#####Requirements for building native code with the NDK within or outside of the Android Studio IDE:
@@ -58,7 +56,8 @@ For help with the Eclipse to Android Studio IDE transition, see the document htt
58
56
##Building Native Android Libraries
59
57
To build using the Android NDK toolchain, placed in the downloaded NDK is a script file, for Mac OS X, named `ndk-build` or, for Windows Desktop, named `ndk-build.cmd.` When Android Studio is used to download and install the NDK, by default, the NDK is installed directly under the Android SDK root folder. Also, by default, the NDK root folder is named "ndk-bundle."
60
58
61
-
> Note:<br/>
59
+
> Note:
60
+
>
62
61
> Due to the knife-edge roll of NDK version 11 by developers.android.com, it's recommended that ARToolKit Android developers download, install and use NDK version 11 or greater. Not doing so can result in link incompatibilities between your native libraries and their dependency on ARToolKit prebuilt native libraries.
63
62
64
63
The next step after installing the Android SDK and NDK is to set some environment variables (recommended for both Mac OS X and Windows Desktop development environments). For Windows Desktop, the following can be defined as Windows system environment variables or exported by the Git bash shell's ".bash_profile" startup file.
@@ -85,19 +84,17 @@ These are the ARToolKit binaries built for the various Android ABIs. The Android
85
84
86
85
To build the Android Studio example app projects that do include native C/C++ source code and to build the project's C/C++ source, after executing the "./build" script file, execute "./build_native_examples.sh", without arguments. When "build_native_examples.sh" script completes without errors, the native Android Studio example projects are populated with the content of the generated *libs* folder. Using an actual example Android Studio project, "ARSimpleNativeProj," the *libs* folder is copied here:
<ARTK SDK or repo root>/AndroidStudioProjects/ARSimpleNativeProj/aRSimpleNative/src/main/
89
+
```
93
90
94
91
Once the native dependencies are built and copied, open an Android Studio example project and build the project's Java source files. If all builds, deploy to an Android simulated device or a *real* development device. Note: the camera doesn't work on simulated devices so it's best to test with *real* devices.
95
92
96
93
To use the native ARToolKit binaries in your own Android application, you will need to copy the *libs* folder generated by the "build.sh" script to your Android application project folder using the following project offset:
97
94
98
-
<pstyle="margin-left: 2em;">
99
-
<Android Studio Project>/<module>/src/main
0 commit comments