diff --git a/examples/tutorials/android/.gitignore b/examples/tutorials/android/.gitignore new file mode 100644 index 0000000000..7f6823bcc0 --- /dev/null +++ b/examples/tutorials/android/.gitignore @@ -0,0 +1,2 @@ +.gradle +build/ diff --git a/examples/tutorials/android/android-tutorial-1/.gitignore b/examples/tutorials/android/android-tutorial-1/.gitignore new file mode 100644 index 0000000000..a97ee90b61 --- /dev/null +++ b/examples/tutorials/android/android-tutorial-1/.gitignore @@ -0,0 +1,4 @@ +.externalNativeBuild/ +assets/ +gst-build-*/ +src/org/freedesktop/gstreamer/GStreamer.java diff --git a/examples/tutorials/android/android-tutorial-1/build.gradle b/examples/tutorials/android/android-tutorial-1/build.gradle new file mode 100644 index 0000000000..32265afc19 --- /dev/null +++ b/examples/tutorials/android/android-tutorial-1/build.gradle @@ -0,0 +1,72 @@ +apply plugin: 'com.android.application' + +android { + compileSdkVersion 23 + buildToolsVersion '27.0.3' + + defaultConfig { + applicationId "org.freedesktop.gstreamer.tutorials.tutorial_1" + minSdkVersion 15 + targetSdkVersion 15 + versionCode 1 + versionName "1.0" + + + externalNativeBuild { + ndkBuild { + def gstRoot + + if (project.hasProperty('gstAndroidRoot')) + gstRoot = project.gstAndroidRoot + else + gstRoot = System.env.GSTREAMER_ROOT_ANDROID + + if (gstRoot == null) + throw new GradleException('GSTREAMER_ROOT_ANDROID must be set, or "gstAndroidRoot" must be defined in your gradle.properties in the top level directory of the unpacked universal GStreamer Android binaries') + + arguments "NDK_APPLICATION_MK=jni/Application.mk", "GSTREAMER_JAVA_SRC_DIR=src", "GSTREAMER_ROOT_ANDROID=$gstRoot", "GSTREAMER_ASSETS_DIR=src/assets" + + targets "tutorial-1" + + // All archs except MIPS and MIPS64 are supported + abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86' + // x86_64 abis disabled because of https://bugzilla.gnome.org/show_bug.cgi?id=795454 + } + } + } + + buildTypes { + release { + minifyEnabled false + proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' + sourceSets { + main { + manifest.srcFile 'AndroidManifest.xml' + java.srcDirs = ['src'] + resources.srcDirs = ['src'] + aidl.srcDirs = ['src'] + renderscript.srcDirs = ['src'] + res.srcDirs = ['res'] + assets.srcDirs = ['assets'] + } + } + } + } + + externalNativeBuild { + ndkBuild { + path 'jni/Android.mk' + } + } +} + +afterEvaluate { + compileDebugJavaWithJavac.dependsOn 'externalNativeBuildDebug' + compileReleaseJavaWithJavac.dependsOn 'externalNativeBuildRelease' +} + +dependencies { + compile fileTree(dir: 'libs', include: ['*.jar']) + testCompile 'junit:junit:4.12' + compile 'com.android.support:appcompat-v7:23.1.1' +} diff --git a/examples/tutorials/android/android-tutorial-2/.gitignore b/examples/tutorials/android/android-tutorial-2/.gitignore new file mode 100644 index 0000000000..a97ee90b61 --- /dev/null +++ b/examples/tutorials/android/android-tutorial-2/.gitignore @@ -0,0 +1,4 @@ +.externalNativeBuild/ +assets/ +gst-build-*/ +src/org/freedesktop/gstreamer/GStreamer.java diff --git a/examples/tutorials/android/android-tutorial-2/build.gradle b/examples/tutorials/android/android-tutorial-2/build.gradle new file mode 100644 index 0000000000..1cc6177ed0 --- /dev/null +++ b/examples/tutorials/android/android-tutorial-2/build.gradle @@ -0,0 +1,72 @@ +apply plugin: 'com.android.application' + +android { + compileSdkVersion 23 + buildToolsVersion '27.0.3' + + defaultConfig { + applicationId "org.freedesktop.gstreamer.tutorials.tutorial_2" + minSdkVersion 15 + targetSdkVersion 15 + versionCode 1 + versionName "1.0" + + + externalNativeBuild { + ndkBuild { + def gstRoot + + if (project.hasProperty('gstAndroidRoot')) + gstRoot = project.gstAndroidRoot + else + gstRoot = System.env.GSTREAMER_ROOT_ANDROID + + if (gstRoot == null) + throw new GradleException('GSTREAMER_ROOT_ANDROID must be set, or "gstAndroidRoot" must be defined in your gradle.properties in the top level directory of the unpacked universal GStreamer Android binaries') + + arguments "NDK_APPLICATION_MK=jni/Application.mk", "GSTREAMER_JAVA_SRC_DIR=src", "GSTREAMER_ROOT_ANDROID=$gstRoot", "GSTREAMER_ASSETS_DIR=src/assets" + + targets "tutorial-2" + + // All archs except MIPS and MIPS64 are supported + abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86' + // x86_64 abis disabled because of https://bugzilla.gnome.org/show_bug.cgi?id=795454 + } + } + } + + buildTypes { + release { + minifyEnabled false + proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' + sourceSets { + main { + manifest.srcFile 'AndroidManifest.xml' + java.srcDirs = ['src'] + resources.srcDirs = ['src'] + aidl.srcDirs = ['src'] + renderscript.srcDirs = ['src'] + res.srcDirs = ['res'] + assets.srcDirs = ['assets'] + } + } + } + } + + externalNativeBuild { + ndkBuild { + path 'jni/Android.mk' + } + } +} + +afterEvaluate { + compileDebugJavaWithJavac.dependsOn 'externalNativeBuildDebug' + compileReleaseJavaWithJavac.dependsOn 'externalNativeBuildRelease' +} + +dependencies { + compile fileTree(dir: 'libs', include: ['*.jar']) + testCompile 'junit:junit:4.12' + compile 'com.android.support:appcompat-v7:23.1.1' +} diff --git a/examples/tutorials/android/android-tutorial-3/.gitignore b/examples/tutorials/android/android-tutorial-3/.gitignore new file mode 100644 index 0000000000..a97ee90b61 --- /dev/null +++ b/examples/tutorials/android/android-tutorial-3/.gitignore @@ -0,0 +1,4 @@ +.externalNativeBuild/ +assets/ +gst-build-*/ +src/org/freedesktop/gstreamer/GStreamer.java diff --git a/examples/tutorials/android/android-tutorial-3/build.gradle b/examples/tutorials/android/android-tutorial-3/build.gradle new file mode 100644 index 0000000000..d16848ab73 --- /dev/null +++ b/examples/tutorials/android/android-tutorial-3/build.gradle @@ -0,0 +1,72 @@ +apply plugin: 'com.android.application' + +android { + compileSdkVersion 23 + buildToolsVersion '27.0.3' + + defaultConfig { + applicationId "org.freedesktop.gstreamer.tutorials.tutorial_3" + minSdkVersion 15 + targetSdkVersion 15 + versionCode 1 + versionName "1.0" + + + externalNativeBuild { + ndkBuild { + def gstRoot + + if (project.hasProperty('gstAndroidRoot')) + gstRoot = project.gstAndroidRoot + else + gstRoot = System.env.GSTREAMER_ROOT_ANDROID + + if (gstRoot == null) + throw new GradleException('GSTREAMER_ROOT_ANDROID must be set, or "gstAndroidRoot" must be defined in your gradle.properties in the top level directory of the unpacked universal GStreamer Android binaries') + + arguments "NDK_APPLICATION_MK=jni/Application.mk", "GSTREAMER_JAVA_SRC_DIR=src", "GSTREAMER_ROOT_ANDROID=$gstRoot", "GSTREAMER_ASSETS_DIR=src/assets" + + targets "tutorial-3" + + // All archs except MIPS and MIPS64 are supported + abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86' + // x86_64 abis disabled because of https://bugzilla.gnome.org/show_bug.cgi?id=795454 + } + } + } + + buildTypes { + release { + minifyEnabled false + proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' + sourceSets { + main { + manifest.srcFile 'AndroidManifest.xml' + java.srcDirs = ['src'] + resources.srcDirs = ['src'] + aidl.srcDirs = ['src'] + renderscript.srcDirs = ['src'] + res.srcDirs = ['res'] + assets.srcDirs = ['assets'] + } + } + } + } + + externalNativeBuild { + ndkBuild { + path 'jni/Android.mk' + } + } +} + +afterEvaluate { + compileDebugJavaWithJavac.dependsOn 'externalNativeBuildDebug' + compileReleaseJavaWithJavac.dependsOn 'externalNativeBuildRelease' +} + +dependencies { + compile fileTree(dir: 'libs', include: ['*.jar']) + testCompile 'junit:junit:4.12' + compile 'com.android.support:appcompat-v7:23.1.1' +} diff --git a/examples/tutorials/android/android-tutorial-4/.gitignore b/examples/tutorials/android/android-tutorial-4/.gitignore new file mode 100644 index 0000000000..f34cf307c0 --- /dev/null +++ b/examples/tutorials/android/android-tutorial-4/.gitignore @@ -0,0 +1,4 @@ +.externalNativeBuild/ +assets/ +gst-build-*/ +src/org/ diff --git a/examples/tutorials/android/android-tutorial-4/build.gradle b/examples/tutorials/android/android-tutorial-4/build.gradle new file mode 100644 index 0000000000..36a3e38189 --- /dev/null +++ b/examples/tutorials/android/android-tutorial-4/build.gradle @@ -0,0 +1,72 @@ +apply plugin: 'com.android.application' + +android { + compileSdkVersion 23 + buildToolsVersion '27.0.3' + + defaultConfig { + applicationId "org.freedesktop.gstreamer.tutorials.tutorial_4" + minSdkVersion 15 + targetSdkVersion 15 + versionCode 1 + versionName "1.0" + + + externalNativeBuild { + ndkBuild { + def gstRoot + + if (project.hasProperty('gstAndroidRoot')) + gstRoot = project.gstAndroidRoot + else + gstRoot = System.env.GSTREAMER_ROOT_ANDROID + + if (gstRoot == null) + throw new GradleException('GSTREAMER_ROOT_ANDROID must be set, or "gstAndroidRoot" must be defined in your gradle.properties in the top level directory of the unpacked universal GStreamer Android binaries') + + arguments "NDK_APPLICATION_MK=jni/Application.mk", "GSTREAMER_JAVA_SRC_DIR=src", "GSTREAMER_ROOT_ANDROID=$gstRoot", "GSTREAMER_ASSETS_DIR=src/assets" + + targets "tutorial-4" + + // All archs except MIPS and MIPS64 are supported + abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86' + // x86_64 abis disabled because of https://bugzilla.gnome.org/show_bug.cgi?id=795454 + } + } + } + + buildTypes { + release { + minifyEnabled false + proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' + sourceSets { + main { + manifest.srcFile 'AndroidManifest.xml' + java.srcDirs = ['src'] + resources.srcDirs = ['src'] + aidl.srcDirs = ['src'] + renderscript.srcDirs = ['src'] + res.srcDirs = ['res'] + assets.srcDirs = ['assets'] + } + } + } + } + + externalNativeBuild { + ndkBuild { + path 'jni/Android.mk' + } + } +} + +afterEvaluate { + compileDebugJavaWithJavac.dependsOn 'externalNativeBuildDebug' + compileReleaseJavaWithJavac.dependsOn 'externalNativeBuildRelease' +} + +dependencies { + compile fileTree(dir: 'libs', include: ['*.jar']) + testCompile 'junit:junit:4.12' + compile 'com.android.support:appcompat-v7:23.1.1' +} diff --git a/examples/tutorials/android/android-tutorial-5/.gitignore b/examples/tutorials/android/android-tutorial-5/.gitignore new file mode 100644 index 0000000000..f34cf307c0 --- /dev/null +++ b/examples/tutorials/android/android-tutorial-5/.gitignore @@ -0,0 +1,4 @@ +.externalNativeBuild/ +assets/ +gst-build-*/ +src/org/ diff --git a/examples/tutorials/android/android-tutorial-5/build.gradle b/examples/tutorials/android/android-tutorial-5/build.gradle new file mode 100644 index 0000000000..136e2c3ccb --- /dev/null +++ b/examples/tutorials/android/android-tutorial-5/build.gradle @@ -0,0 +1,72 @@ +apply plugin: 'com.android.application' + +android { + compileSdkVersion 23 + buildToolsVersion '27.0.3' + + defaultConfig { + applicationId "org.freedesktop.gstreamer.tutorials.tutorial_5" + minSdkVersion 15 + targetSdkVersion 15 + versionCode 1 + versionName "1.0" + + + externalNativeBuild { + ndkBuild { + def gstRoot + + if (project.hasProperty('gstAndroidRoot')) + gstRoot = project.gstAndroidRoot + else + gstRoot = System.env.GSTREAMER_ROOT_ANDROID + + if (gstRoot == null) + throw new GradleException('GSTREAMER_ROOT_ANDROID must be set, or "gstAndroidRoot" must be defined in your gradle.properties in the top level directory of the unpacked universal GStreamer Android binaries') + + arguments "NDK_APPLICATION_MK=jni/Application.mk", "GSTREAMER_JAVA_SRC_DIR=src", "GSTREAMER_ROOT_ANDROID=$gstRoot", "GSTREAMER_ASSETS_DIR=src/assets" + + targets "tutorial-5" + + // All archs except MIPS and MIPS64 are supported + abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86' + // x86_64 abis disabled because of https://bugzilla.gnome.org/show_bug.cgi?id=795454 + } + } + } + + buildTypes { + release { + minifyEnabled false + proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' + sourceSets { + main { + manifest.srcFile 'AndroidManifest.xml' + java.srcDirs = ['src'] + resources.srcDirs = ['src'] + aidl.srcDirs = ['src'] + renderscript.srcDirs = ['src'] + res.srcDirs = ['res'] + assets.srcDirs = ['assets'] + } + } + } + } + + externalNativeBuild { + ndkBuild { + path 'jni/Android.mk' + } + } +} + +afterEvaluate { + compileDebugJavaWithJavac.dependsOn 'externalNativeBuildDebug' + compileReleaseJavaWithJavac.dependsOn 'externalNativeBuildRelease' +} + +dependencies { + compile fileTree(dir: 'libs', include: ['*.jar']) + testCompile 'junit:junit:4.12' + compile 'com.android.support:appcompat-v7:23.1.1' +} diff --git a/examples/tutorials/android/build.gradle b/examples/tutorials/android/build.gradle new file mode 100644 index 0000000000..4a706d96c4 --- /dev/null +++ b/examples/tutorials/android/build.gradle @@ -0,0 +1,25 @@ +// Top-level build file where you can add configuration options common to all sub-projects/modules. + +buildscript { + repositories { + jcenter() + google() + } + dependencies { + classpath 'com.android.tools.build:gradle:3.1.1' + + // NOTE: Do not place your application dependencies here; they belong + // in the individual module build.gradle files + } +} + +allprojects { + repositories { + jcenter() + google() + } +} + +task clean(type: Delete) { + delete rootProject.buildDir +} diff --git a/examples/tutorials/android/gradle/wrapper/gradle-wrapper.jar b/examples/tutorials/android/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000..05ef575b0c Binary files /dev/null and b/examples/tutorials/android/gradle/wrapper/gradle-wrapper.jar differ diff --git a/examples/tutorials/android/gradle/wrapper/gradle-wrapper.properties b/examples/tutorials/android/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000000..205e07cbee --- /dev/null +++ b/examples/tutorials/android/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,6 @@ +#Sat Apr 21 19:58:19 WEST 2018 +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-4.4-all.zip diff --git a/examples/tutorials/android/gradlew b/examples/tutorials/android/gradlew new file mode 100755 index 0000000000..9d82f78915 --- /dev/null +++ b/examples/tutorials/android/gradlew @@ -0,0 +1,160 @@ +#!/usr/bin/env bash + +############################################################################## +## +## Gradle start up script for UN*X +## +############################################################################## + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS="" + +APP_NAME="Gradle" +APP_BASE_NAME=`basename "$0"` + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD="maximum" + +warn ( ) { + echo "$*" +} + +die ( ) { + echo + echo "$*" + echo + exit 1 +} + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +case "`uname`" in + CYGWIN* ) + cygwin=true + ;; + Darwin* ) + darwin=true + ;; + MINGW* ) + msys=true + ;; +esac + +# Attempt to set APP_HOME +# Resolve links: $0 may be a link +PRG="$0" +# Need this for relative symlinks. +while [ -h "$PRG" ] ; do + ls=`ls -ld "$PRG"` + link=`expr "$ls" : '.*-> \(.*\)$'` + if expr "$link" : '/.*' > /dev/null; then + PRG="$link" + else + PRG=`dirname "$PRG"`"/$link" + fi +done +SAVED="`pwd`" +cd "`dirname \"$PRG\"`/" >/dev/null +APP_HOME="`pwd -P`" +cd "$SAVED" >/dev/null + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD="$JAVA_HOME/jre/sh/java" + else + JAVACMD="$JAVA_HOME/bin/java" + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD="java" + which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." +fi + +# Increase the maximum file descriptors if we can. +if [ "$cygwin" = "false" -a "$darwin" = "false" ] ; then + MAX_FD_LIMIT=`ulimit -H -n` + if [ $? -eq 0 ] ; then + if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then + MAX_FD="$MAX_FD_LIMIT" + fi + ulimit -n $MAX_FD + if [ $? -ne 0 ] ; then + warn "Could not set maximum file descriptor limit: $MAX_FD" + fi + else + warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" + fi +fi + +# For Darwin, add options to specify how the application appears in the dock +if $darwin; then + GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" +fi + +# For Cygwin, switch paths to Windows format before running java +if $cygwin ; then + APP_HOME=`cygpath --path --mixed "$APP_HOME"` + CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` + JAVACMD=`cygpath --unix "$JAVACMD"` + + # We build the pattern for arguments to be converted via cygpath + ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` + SEP="" + for dir in $ROOTDIRSRAW ; do + ROOTDIRS="$ROOTDIRS$SEP$dir" + SEP="|" + done + OURCYGPATTERN="(^($ROOTDIRS))" + # Add a user-defined pattern to the cygpath arguments + if [ "$GRADLE_CYGPATTERN" != "" ] ; then + OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" + fi + # Now convert the arguments - kludge to limit ourselves to /bin/sh + i=0 + for arg in "$@" ; do + CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` + CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option + + if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition + eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` + else + eval `echo args$i`="\"$arg\"" + fi + i=$((i+1)) + done + case $i in + (0) set -- ;; + (1) set -- "$args0" ;; + (2) set -- "$args0" "$args1" ;; + (3) set -- "$args0" "$args1" "$args2" ;; + (4) set -- "$args0" "$args1" "$args2" "$args3" ;; + (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; + (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; + (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; + (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; + (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; + esac +fi + +# Split up the JVM_OPTS And GRADLE_OPTS values into an array, following the shell quoting and substitution rules +function splitJvmOpts() { + JVM_OPTS=("$@") +} +eval splitJvmOpts $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS +JVM_OPTS[${#JVM_OPTS[*]}]="-Dorg.gradle.appname=$APP_BASE_NAME" + +exec "$JAVACMD" "${JVM_OPTS[@]}" -classpath "$CLASSPATH" org.gradle.wrapper.GradleWrapperMain "$@" diff --git a/examples/tutorials/android/settings.gradle b/examples/tutorials/android/settings.gradle new file mode 100644 index 0000000000..a02eae22a0 --- /dev/null +++ b/examples/tutorials/android/settings.gradle @@ -0,0 +1,5 @@ +include ':android-tutorial-1' +include ':android-tutorial-2' +include ':android-tutorial-3' +include ':android-tutorial-4' +include ':android-tutorial-5' diff --git a/markdown/installing/for-android-development.md b/markdown/installing/for-android-development.md index b8917b55c1..db04ded7ec 100644 --- a/markdown/installing/for-android-development.md +++ b/markdown/installing/for-android-development.md @@ -192,6 +192,51 @@ OpenGL ES). > your Android NDK installation. You might need the free [7-Zip > archiving utility] +#### Using gradle from the command-line + +Edit examples/tutorials/android/gradle.properties in order to set gstAndroidRoot to point to the +unpacked GStreamer Android binaries. + +Then, to build and deploy the tutorials to your device, use a command similar to: + +```bash +$ cd examples/tutorials/android +$ PATH=~/dev/android/tools/bin:~/dev/android/ndk-bundle:$PATH ANDROID_HOME="$HOME/dev/android/" ./gradlew installDebug +``` + +To build and deploy a single tutorial: + +```bash +$ cd examples/tutorials/android +$ GSTREAMER_ROOT_ANDROID=/path/to/gst-android-1.14/ PATH=~/dev/android/tools/bin:~/dev/android/ndk-bundle:$PATH ANDROID_HOME="$HOME/dev/android/" ./gradlew :android-tutorial-1:installDebug +``` + +To run the application, you can either directly launch it from the device, +or from the command line: + +```bash +$ adb shell am start -n adb shell am start -n org.freedesktop.gstreamer.tutorials.tutorial_1/.Tutorial1 +``` + +To see the GStreamer logs at runtime: + +```bash +$ adb logcat | egrep '(gst)' +``` + +#### Using Android-studio + +Edit examples/tutorials/android/gradle.properties in order to set gstAndroidRoot to point to the +unpacked GStreamer Android binaries. + +Launch Android-studio, opening examples/tutorials/android/ as a project. + +The project should build automatically, once it has done successfully, +it should be possible to run the tutorials with Run > Run 'tutorial X', provided +a device is attached and USB debugging enabled. + +The logs can be seen in the logcat tab. + ### Creating new projects Create a normal NDK project, either from the command line as described diff --git a/markdown/tutorials/android/link-against-gstreamer.md b/markdown/tutorials/android/link-against-gstreamer.md index 3eb420f472..dcf71af529 100644 --- a/markdown/tutorials/android/link-against-gstreamer.md +++ b/markdown/tutorials/android/link-against-gstreamer.md @@ -11,7 +11,9 @@ linkage problems. ## Hello GStreamer \[Java code\] -The tutorial code is in the [gst-docs](https://cgit.freedesktop.org/gstreamer/gst-docs/) in the `tutorials/android-tutorial-1` subdirectory. This directories contains the usual Android NDK structure: a `src` folder for the Java code, +The tutorial code is in the [gst-docs](https://cgit.freedesktop.org/gstreamer/gst-docs/) +in the `examples/tutorials/android/android-tutorial-1` subdirectory. +This directory contains the usual Android NDK structure: a `src` folder for the Java code, a `jni` folder for the C code and a `res` folder for UI resources. We recommend that you open this project in Eclipse (as explained @@ -278,4 +280,4 @@ taken when developing specifically for the Android platform. As usual, it has been a pleasure having you here, and see you soon\! - [screenshot]: images/tutorials/android-link-against-gstreamer-screenshot.png \ No newline at end of file + [screenshot]: images/tutorials/android-link-against-gstreamer-screenshot.png