android/ndk-samples
1
0
Fork 0
mirror of https://github.com/android/ndk-samples synced 2025-11-06 15:35:36 +08:00
Code Issues Packages Projects Releases Wiki Activity

Remove obsolete, duplicate, and useless docs.

Browse Source 
License text, setup instructions, and support info do not need to be
duplicated into every README, since they're already in the top-level
README. They were originally in each sample because the samples used to
each be separate Android Studio projects with different requirements
that could be checkout out independently in Android Studio. This is no
longer the case.

Most of the docs also included text along the lines of "This sample uses
the new Android Studio with CMake support", which hasn't been new since
2015, so doesn't really need to be said.

The prerequisites were mostly not true. Android Studio is not required
for any of this. Cloning the repo and running `./gradlew build` is
sufficient to build all the samples. They also were not being kept
up-to-date at all, since they mostly said "Android Studio 2.2 or newer",
which was definitely not true. I'm not what the oldest version of
Android Studio that will work here is, but I don't actually test
anything but the latest so claiming anything otherwise is just
misleading.

I haven't pruned or edited any of the real content of the docs. I'm sure
there are plenty of edits to be made there and a lot of expansion to do,
but those changes will be less mechanical and will happen separately.
This commit is contained in:
Dan Albert
2025-09-23 13:37:06 -07:00
committed by Dan Albert
parent 59791f25df
commit aa52693f43
20 changed files with 2 additions and 898 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
README.md
View File

@@ -146,7 +146,7 @@ For questions about using the NDK or the platform APIs, you can ask on:
## License ## License
Copyright 2018 The Android Open Source Project, Inc. Copyright 2015 The Android Open Source Project, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for license agreements. See the NOTICE file distributed with this work for

62
audio-echo/README.md
View File

@@ -6,36 +6,13 @@ there is a optimized audio path that is tuned up for low latency purpose. The
sample creates player/recorder to work in this highly optimized audio sample creates player/recorder to work in this highly optimized audio
path(sometimes called native audio path, path(sometimes called native audio path,
[low latency path](http://stackoverflow.com/questions/14842803/low-latency-audio-playback-on-android?rq=1), [low latency path](http://stackoverflow.com/questions/14842803/low-latency-audio-playback-on-android?rq=1),
or fast audio path). The application is validated against the following or fast audio path).
configurations:
- Android L AndroidOne
- Android M Nexus 5, Nexus 9
This sample uses the new Android Studio with CMake support, and shows how to use
shared stl lib with android studio version 2.2.0, see CMakeLists.txt for details
***Note that OpenSL ES is ***Note that OpenSL ES is
[deprecated from Android 11](https://developer.android.com/preview/features#deprecate-opensl), [deprecated from Android 11](https://developer.android.com/preview/features#deprecate-opensl),
developers are recommended to use [Oboe](https://github.com/google/oboe) library developers are recommended to use [Oboe](https://github.com/google/oboe) library
instead.*** instead.***
## Pre-requisites
- Android Studio 2.2+ with [NDK](https://developer.android.com/ndk/) bundle.
## Getting Started
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio.
1. Open the sample directory.
1. Open *File/Project Structure...*
- Click *Download* or *Select NDK location*.
1. Click *Tools/Android/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
## Usage ## Usage
App will capture audio from android devices and playback on the same device; the App will capture audio from android devices and playback on the same device; the
@@ -98,40 +75,3 @@ A couple of knobs in the code for lower latency purpose:
playback audio experience. The app capture and playback on the same device playback audio experience. The app capture and playback on the same device
\[most of times the same chip\], capture and playback clocks are assumed \[most of times the same chip\], capture and playback clocks are assumed
synchronized naturally \[so we are not dealing with it\] synchronized naturally \[so we are not dealing with it\]
## Credits
- The sample is greatly inspired by native-audio sample
- Don Turner @ Google for the helping of low latency path
- Ian Ni-Lewis @ Google for producer/consumer queue and many others
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2015 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

51
bitmap-plasma/README.md
View File

@@ -5,57 +5,6 @@ Android
[Bitmap](http://developer.android.com/reference/android/graphics/Bitmap.html) [Bitmap](http://developer.android.com/reference/android/graphics/Bitmap.html)
from C code. from C code.
This sample uses the new
[Android Studio CMake plugin](http://tools.android.com/tech-docs/external-c-builds)
with C++ support.
## Pre-requisites
- Android Studio 2.2+ with [NDK](https://developer.android.com/ndk/) bundle.
## Getting Started
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio.
1. Open the sample directory.
1. Open *File/Project Structure...*
- Click *Download* or *Select NDK location*.
1. Click *Tools/Android/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
## Screenshots ## Screenshots
![screenshot](screenshot.png) ![screenshot](screenshot.png)
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2015 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

50
camera/README.md
View File

@@ -18,56 +18,6 @@ Two API samples:
- [Camera2 Java documentation](https://developer.android.com/reference/android/hardware/camera2/package-summary) - [Camera2 Java documentation](https://developer.android.com/reference/android/hardware/camera2/package-summary)
## Pre-requisites
- Android Studio 2.3.0+ with [NDK-r15+](https://developer.android.com/ndk/)
bundle
- Android device running android-24+
## Getting Started
1. Download Android Studio from
[latest stable release](http://developer.android.com/sdk/index.html) or
[canary](http://tools.android.com/download/studio/canary)
1. Launch Android Studio
1. Select "Import project (Eclipse ADT, Gradle,etc)"
1. Browse into downloaded sample directory, select webp/build.gradle
1. Click *Tools/Android/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
## Screenshots ## Screenshots
![screenshot](ndkCamera.png) ![screenshot](ndkCamera.png)
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
For generic questions about Android Camera and other feedbacks, please go to
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-camera)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2015 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

56
endless-tunnel/README.md
View File

@@ -13,26 +13,6 @@ to keep the focus on the Android Studio C++ integration. For example, this game
contains textures and geometry hard-coded in code, which works for small demo contains textures and geometry hard-coded in code, which works for small demo
games like this one, but doesn't scale well to real games. games like this one, but doesn't scale well to real games.
This sample uses the new
[Android Studio CMake plugin](http://tools.android.com/tech-docs/external-c-builds)
with C++ support.
## Pre-requisites
- Android Studio 2.2+ with [NDK](https://developer.android.com/ndk/).
## Getting Started
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio.
1. Open the sample directory.
1. Open *File/Project Structure...*
- Click *Download* or *Select NDK location*.
1. Click *Tools/Android/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
## Screenshots ## Screenshots
![screenshot](screenshot.png) ![screenshot](screenshot.png)
@@ -51,11 +31,6 @@ For more information about this library and its license, please see
[readme.md](https://github.com/g-truc/glm/blob/master/readme.md) and [readme.md](https://github.com/g-truc/glm/blob/master/readme.md) and
[copying](https://github.com/g-truc/glm/blob/master/copying.txt). [copying](https://github.com/g-truc/glm/blob/master/copying.txt).
## Acknowledgements
Most of this code was written by
[Bruno Oliveira](https://plus.google.com/+BrunoOliveira).
## Walkthrough ## Walkthrough
Source code is under app, it only contains C++ code, which is sitting at its Source code is under app, it only contains C++ code, which is sitting at its
@@ -178,34 +153,3 @@ The whole game logic is contained in play_scene.cpp. We won't dive into a full
discussion of it, but start reading from the PlayScene::DoFrame() method and it discussion of it, but start reading from the PlayScene::DoFrame() method and it
should become clear. It's a standard game loop that handles input, updates the should become clear. It's a standard game loop that handles input, updates the
world, checks for collisions and renders. world, checks for collisions and renders.
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2015 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

31
exceptions/README.md
View File

@@ -46,34 +46,3 @@ adapted.
## Screenshot ## Screenshot
![screenshot](screenshot.png) ![screenshot](screenshot.png)
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2022 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

51
gles3jni/README.md
View File

@@ -13,57 +13,6 @@ ES 2.0 path:
- Explicit assignment of attribute locations, eliminating the need to query - Explicit assignment of attribute locations, eliminating the need to query
assignments. assignments.
This sample uses the new
[Android Studio CMake plugin](http://tools.android.com/tech-docs/external-c-builds)
with C++ support.
## Pre-requisites
- Android Studio 1.3+ with [NDK](https://developer.android.com/ndk/) bundle.
## Getting Started
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio.
1. Open the sample directory.
1. Open *File/Project Structure...*
- Click *Download* or *Select NDK location*.
1. Click *Tools/Android/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
## Screenshots ## Screenshots
![screenshot](screenshot.png) ![screenshot](screenshot.png)
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2015 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

52
hello-gl2/README.md
View File

@@ -6,58 +6,6 @@ It uses JNI to do the rendering in C++ over a
[GLSurfaceView](http://developer.android.com/reference/android/opengl/GLSurfaceView.html) [GLSurfaceView](http://developer.android.com/reference/android/opengl/GLSurfaceView.html)
created from a regular Android Java Activity. created from a regular Android Java Activity.
This sample uses the new
[Android Studio CMake plugin](http://tools.android.com/tech-docs/external-c-builds)
with C++ support.
## Pre-requisites
- Android Studio 2.2 preview+ with [NDK](https://developer.android.com/ndk/)
bundle.
## Getting Started
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio.
1. Open the sample directory.
1. Open *File/Project Structure...*
- Click *Download* or *Select NDK location*.
1. Click *Tools/Android/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
## Screenshots ## Screenshots
![screenshot](screenshot.png) ![screenshot](screenshot.png)
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2015 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

47
hello-jni/README.md
View File

@@ -3,53 +3,6 @@
Hello JNI is an Android sample that uses JNI to call C code from a Android Java Hello JNI is an Android sample that uses JNI to call C code from a Android Java
Activity. Activity.
This sample uses the new
[Android Studio CMake plugin](http://tools.android.com/tech-docs/external-c-builds)
with C++ support. For how to use Android Studio, refer to
[Hello-CMake codelab](https://codelabs.developers.google.com/codelabs/android-studio-cmake/index.html)
## Pre-requisites
- Android Studio 4.2+ with [NDK](https://developer.android.com/ndk/) bundle.
## Getting Started
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio.
1. Open the ndk-samples directory.
1. Click *Run* and select *hello-jni.app* from the list.
## Screenshots ## Screenshots
![screenshot](screenshot.png) ![screenshot](screenshot.png)
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2022 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

51
hello-jniCallback/README.md
View File

@@ -6,57 +6,6 @@ from C code
- create a java class instance from C code - create a java class instance from C code
- call java class static and non-static member functions - call java class static and non-static member functions
This sample uses the new
[Android Studio CMake plugin](http://tools.android.com/tech-docs/external-c-builds)
with C++ support.
## Pre-requisites
- Android Studio 2.2+ with [NDK](https://developer.android.com/ndk/) bundle.
## Getting Started
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio.
1. Open the sample directory.
1. Open *File/Project Structure...*
- Click *Download* or *Select NDK location*.
1. Click *Tools/Android/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
## Screenshots ## Screenshots
![screenshot](screenshot.png) ![screenshot](screenshot.png)
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2015 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

47
hello-oboe/README.md
View File

@@ -18,22 +18,6 @@ checkout Prefab steps in
If you like to build your app with the Oboe library source code, refer to the If you like to build your app with the Oboe library source code, refer to the
examples in the Oboe repository. examples in the Oboe repository.
## Pre-requisites
- Android Studio 4.0+ with [NDK](https://developer.android.com/ndk/) bundle.
## Getting Started
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio.
1. Open the sample directory.
1. Open *File/Project Structure...*
- Click *Download* or *Select NDK location*.
1. Click *Tools/Android/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
## Screenshot ## Screenshot
![screenshot](screenshot.png) ![screenshot](screenshot.png)
@@ -42,34 +26,3 @@ examples in the Oboe repository.
Tap and hold the screen to play audio. The app will render a 440Hz sine wave Tap and hold the screen to play audio. The app will render a 440Hz sine wave
while the screen is being pressed. while the screen is being pressed.
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2019 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

29
hello-vulkan/README.md
View File

@@ -12,22 +12,6 @@ features such as:
the application side. You can read more about it here: the application side. You can read more about it here:
https://developer.android.com/games/optimize/vulkan-prerotation https://developer.android.com/games/optimize/vulkan-prerotation
## Pre-requisites
- Android Studio 4.2+ with [NDK](https://developer.android.com/ndk/) bundle.
## Getting Started
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio.
1. Open the sample directory.
1. Open *File/Project Structure...*
- Click *Download* or *Select NDK location*.
1. Click *File/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
## Screenshots ## Screenshots
![Vulkan Triangle example](documentation-assets/example-triangle.png) ![Vulkan Triangle example](documentation-assets/example-triangle.png)
@@ -61,16 +45,3 @@ you do not require any additional/custom application behaviour, the
Android(Kotlin) source files can be completely removed and the Android(Kotlin) source files can be completely removed and the
AndroidManifest.xml tweaked as specified here: AndroidManifest.xml tweaked as specified here:
https://developer.android.com/ndk/samples/sample_na https://developer.android.com/ndk/samples/sample_na
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)

51
native-activity/README.md
View File

@@ -20,57 +20,6 @@ clear.
[GameActivity]: https://developer.android.com/games/agdk/game-activity [GameActivity]: https://developer.android.com/games/agdk/game-activity
[NativeActivity]: http://developer.android.com/reference/android/app/NativeActivity.html [NativeActivity]: http://developer.android.com/reference/android/app/NativeActivity.html
This sample uses the new
[Android Studio CMake plugin](http://tools.android.com/tech-docs/external-c-builds)
with C++ support.
## Pre-requisites
- Android Studio 2.2+ with [NDK](https://developer.android.com/ndk/) bundle.
## Getting Started
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio.
1. Open the sample directory.
1. Open *File/Project Structure...*
- Click *Download* or *Select NDK location*.
1. Click *Tools/Android/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
## Screenshots ## Screenshots
![screenshot](screenshot.png) ![screenshot](screenshot.png)
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2015 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

47
native-audio/README.md
View File

@@ -13,22 +13,6 @@ with C++ support.
developers are recommended to use [Oboe](https://github.com/google/oboe) library developers are recommended to use [Oboe](https://github.com/google/oboe) library
instead.*** instead.***
## Pre-requisites
- Android Studio 2.2+ with [NDK](https://developer.android.com/ndk/) bundle.
## Getting Started
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio.
1. Open the sample directory.
1. Open *File/Project Structure...*
- Click *Download* or *Select NDK location*.
1. Click *Tools/Android/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
## Screenshots ## Screenshots
![screenshot](screenshot.png) ![screenshot](screenshot.png)
@@ -37,34 +21,3 @@ instead.***
- URI Player streaming is - URI Player streaming is
[broken](https://github.com/googlesamples/android-ndk/issues/229) [broken](https://github.com/googlesamples/android-ndk/issues/229)
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2015 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

53
native-codec/README.md
View File

@@ -11,59 +11,6 @@ is provided as an example. To add your own files:
- compile and run app - compile and run app
- from android device, select your stream - from android device, select your stream
This sample uses the new
[Android Studio CMake plugin](http://tools.android.com/tech-docs/external-c-builds)
with C++ support.
## Pre-requisites
- Android Studio 2.2+ with [NDK](https://developer.android.com/ndk/) bundle.
## Getting Started
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio.
1. Open the sample directory.
1. Open *File/Project Structure...*
- Click *Download* or *Select NDK location*.
1. Click *Tools/Android/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
1. Open a terminal prompt and run `adb push testfile.mp4 /sdcard/testfile.mp4`
to copy the test video file.
## Screenshots ## Screenshots
![screenshot](screenshot.png) ![screenshot](screenshot.png)
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2015 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

56
native-midi/README.md
View File

@@ -36,62 +36,6 @@ devices running Android Qt+. An example configure can be:
![Configure](config.png) ![Configure](config.png)
## Getting Started
1. [Download Android Studio 3.4 beta](http://developer.android.com/sdk/index.html)
1. Launch Android Studio, and install all updates that Studio prompts
1. Open the sample directory.
1. Open *Tools/SDK Manager/SDK Tools*, then "NDK"; and update it to NDK-r20+.
1. Click *File/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
**Note for stable Android Studio** Stable Android Studio does not automatically
download and install NDK beta versions; but you could still use it to build this
sample with one of the following ways
- switching to the beta update channel by going to Preferences->Check for
updates->Configure automatic updates. Once you've changed to the beta channel
you should see NDK r20 in the list of SDK Tools.
- manually download
[ndk-r20-beta or better](https://developer.android.com/ndk/downloads), then
add `ndk.dir=$your-downloaded-ndk-r20-dir` to your
`native-midi/local.properties` (this is studio generated file).
## Screenshots ## Screenshots
![screenshot](screenshot.png) ![screenshot](screenshot.png)
## Authors
- pmclean@ of Android team
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2019 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

31
sanitizers/README.md
View File

@@ -82,34 +82,3 @@ This triggers a crash when you build and run the ubsan variant, and the logcat
panel tells you what's going on: panel tells you what's going on:
![ubsan](ubsan.png) ![ubsan](ubsan.png)
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2022 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

49
sensor-graph/README.md
View File

@@ -8,55 +8,6 @@ It demonstrate usage of the following Native C++ API:
- [Sensors](http://developer.android.com/ndk/reference/group___sensor.html) - [Sensors](http://developer.android.com/ndk/reference/group___sensor.html)
- [Assets](http://developer.android.com/ndk/reference/group___asset.html) - [Assets](http://developer.android.com/ndk/reference/group___asset.html)
This sample uses the new
[Android Studio CMake plugin](http://tools.android.com/tech-docs/external-c-builds)
with C++ support.
## Pre-requisites
- Android Studio 2.2+ with [NDK](https://developer.android.com/ndk/) bundle.
## Getting Started
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio.
1. Open `android-ndk/sensor-graph` sample.
1. Open *File/Project Structure...*
1. Click *Download* or *Select NDK location*.
1. Click *Tools/Android/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
## Screenshots ## Screenshots
![screenshot](screenshot.png) ![screenshot](screenshot.png)
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2015 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

53
teapots/README.md
View File

@@ -14,59 +14,6 @@ demonstrate Android NDK platform features:
- image-decoder: Same as textured-teapot, except that texture decoding is done - image-decoder: Same as textured-teapot, except that texture decoding is done
with the ImageDecoder API introduced in Android 11 (Android NDK r21b) with the ImageDecoder API introduced in Android 11 (Android NDK r21b)
This sample uses the new
[Android Studio CMake plugin](http://tools.android.com/tech-docs/external-c-builds)
with C++ support.
## Prerequisites
- Android Studio 4.0.0 with [NDK](https://developer.android.com/ndk/)
- Android
[NDK 21.1+ installed](https://github.com/android/ndk-samples/wiki/Configure-NDK-Path)
## Getting Started
1. [Download Android Studio](http://developer.android.com/sdk/index.html)
1. Launch Android Studio.
1. Open the sample directory.
1. Open *File/Project Structure...*
- Click *Download* or *Select NDK location*.
1. Click *Tools/Android/Sync Project with Gradle Files*.
1. Click *Run/Run 'app'*.
## Screenshots ## Screenshots
![screenshot](screenshot.png) ![screenshot](screenshot.png)
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/android/ndk-samples/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/android/ndk-samples/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedback](http://tools.android.com/feedback)
## License
Copyright 2020 Google LLC.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.

31
unit-test/README.md
View File

@@ -109,34 +109,3 @@ Which is: 3
## Screenshot ## Screenshot
![screenshot](screenshot.png) ![screenshot](screenshot.png)
## Support
If you've found an error in these samples, please
[file an issue](https://github.com/googlesamples/android-ndk/issues/new).
Patches are encouraged, and may be submitted by
[forking this project](https://github.com/googlesamples/android-ndk/fork) and
submitting a pull request through GitHub. Please see
[CONTRIBUTING.md](../CONTRIBUTING.md) for more details.
- [Stack Overflow](http://stackoverflow.com/questions/tagged/android-ndk)
- [Android Tools Feedbacks](http://tools.android.com/feedback)
## License
Copyright 2022 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.