From 9d2df4195d4b17616a79b2ce6e5be7723d253e48 Mon Sep 17 00:00:00 2001 From: Dan Albert Date: Tue, 23 Sep 2025 13:37:06 -0700 Subject: [PATCH] Remove obsolete, duplicate, and useless docs. 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. --- README.md | 2 +- audio-echo/README.md | 62 +------------------------------------ bitmap-plasma/README.md | 51 ------------------------------ camera/README.md | 50 ------------------------------ endless-tunnel/README.md | 56 --------------------------------- exceptions/README.md | 31 ------------------- gles3jni/README.md | 51 ------------------------------ hello-gl2/README.md | 52 ------------------------------- hello-jni/README.md | 47 ---------------------------- hello-jniCallback/README.md | 51 ------------------------------ hello-oboe/README.md | 47 ---------------------------- hello-vulkan/README.md | 29 ----------------- native-activity/README.md | 51 ------------------------------ native-audio/README.md | 47 ---------------------------- native-codec/README.md | 53 ------------------------------- native-midi/README.md | 56 --------------------------------- sanitizers/README.md | 31 ------------------- sensor-graph/README.md | 49 ----------------------------- teapots/README.md | 53 ------------------------------- unit-test/README.md | 31 ------------------- 20 files changed, 2 insertions(+), 898 deletions(-) diff --git a/README.md b/README.md index 343533097..715911468 100644 --- a/README.md +++ b/README.md @@ -146,7 +146,7 @@ For questions about using the NDK or the platform APIs, you can ask on: ## 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 license agreements. See the NOTICE file distributed with this work for diff --git a/audio-echo/README.md b/audio-echo/README.md index 51f37583c..67bae273e 100644 --- a/audio-echo/README.md +++ b/audio-echo/README.md @@ -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 path(sometimes called native audio path, [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 -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 +or fast audio path). ***Note that OpenSL ES is [deprecated from Android 11](https://developer.android.com/preview/features#deprecate-opensl), developers are recommended to use [Oboe](https://github.com/google/oboe) library 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 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 \[most of times the same chip\], capture and playback clocks are assumed 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. diff --git a/bitmap-plasma/README.md b/bitmap-plasma/README.md index 73c6fdf25..841d12a99 100644 --- a/bitmap-plasma/README.md +++ b/bitmap-plasma/README.md @@ -5,57 +5,6 @@ Android [Bitmap](http://developer.android.com/reference/android/graphics/Bitmap.html) 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 ![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. diff --git a/camera/README.md b/camera/README.md index 258af859f..9de6436ac 100644 --- a/camera/README.md +++ b/camera/README.md @@ -18,56 +18,6 @@ Two API samples: - [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 ![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. diff --git a/endless-tunnel/README.md b/endless-tunnel/README.md index 627f9c2e0..b81b7e5cf 100644 --- a/endless-tunnel/README.md +++ b/endless-tunnel/README.md @@ -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 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 ![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 [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 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 should become clear. It's a standard game loop that handles input, updates the 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. diff --git a/exceptions/README.md b/exceptions/README.md index a07830bbf..2a0bd69e1 100644 --- a/exceptions/README.md +++ b/exceptions/README.md @@ -46,34 +46,3 @@ adapted. ## Screenshot ![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. diff --git a/gles3jni/README.md b/gles3jni/README.md index 279101147..482a74c8f 100644 --- a/gles3jni/README.md +++ b/gles3jni/README.md @@ -13,57 +13,6 @@ ES 2.0 path: - Explicit assignment of attribute locations, eliminating the need to query 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 ![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. diff --git a/hello-gl2/README.md b/hello-gl2/README.md index 2916d960f..86da09dd3 100644 --- a/hello-gl2/README.md +++ b/hello-gl2/README.md @@ -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) 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 ![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. diff --git a/hello-jni/README.md b/hello-jni/README.md index cf321a3f2..cee1f4130 100644 --- a/hello-jni/README.md +++ b/hello-jni/README.md @@ -3,53 +3,6 @@ Hello JNI is an Android sample that uses JNI to call C code from a Android Java 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 ![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. diff --git a/hello-jniCallback/README.md b/hello-jniCallback/README.md index 9b8e0d94f..61768b962 100644 --- a/hello-jniCallback/README.md +++ b/hello-jniCallback/README.md @@ -6,57 +6,6 @@ from C code - create a java class instance from C code - 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 ![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. diff --git a/hello-oboe/README.md b/hello-oboe/README.md index cead45edf..e7dab07ff 100644 --- a/hello-oboe/README.md +++ b/hello-oboe/README.md @@ -18,22 +18,6 @@ checkout Prefab steps in If you like to build your app with the Oboe library source code, refer to the 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.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 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. diff --git a/hello-vulkan/README.md b/hello-vulkan/README.md index e445e5ee4..fa68a8401 100644 --- a/hello-vulkan/README.md +++ b/hello-vulkan/README.md @@ -12,22 +12,6 @@ features such as: the application side. You can read more about it here: 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 ![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 AndroidManifest.xml tweaked as specified here: 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) diff --git a/native-activity/README.md b/native-activity/README.md index 6b47adfc5..5e4073763 100644 --- a/native-activity/README.md +++ b/native-activity/README.md @@ -20,57 +20,6 @@ clear. [GameActivity]: https://developer.android.com/games/agdk/game-activity [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 ![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. diff --git a/native-audio/README.md b/native-audio/README.md index 4ba63c011..27709286a 100644 --- a/native-audio/README.md +++ b/native-audio/README.md @@ -13,22 +13,6 @@ with C++ support. developers are recommended to use [Oboe](https://github.com/google/oboe) library 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 ![screenshot](screenshot.png) @@ -37,34 +21,3 @@ instead.*** - URI Player streaming is [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. diff --git a/native-codec/README.md b/native-codec/README.md index 85f4f0314..7b37c7544 100644 --- a/native-codec/README.md +++ b/native-codec/README.md @@ -11,59 +11,6 @@ is provided as an example. To add your own files: - compile and run app - 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 ![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. diff --git a/native-midi/README.md b/native-midi/README.md index 65ef3225f..41a7d613b 100644 --- a/native-midi/README.md +++ b/native-midi/README.md @@ -36,62 +36,6 @@ devices running Android Qt+. An example configure can be: ![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 ![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. diff --git a/sanitizers/README.md b/sanitizers/README.md index c55dc583e..912303366 100644 --- a/sanitizers/README.md +++ b/sanitizers/README.md @@ -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: ![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. diff --git a/sensor-graph/README.md b/sensor-graph/README.md index 1a1654e2d..006ec8331 100644 --- a/sensor-graph/README.md +++ b/sensor-graph/README.md @@ -8,55 +8,6 @@ It demonstrate usage of the following Native C++ API: - [Sensors](http://developer.android.com/ndk/reference/group___sensor.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 ![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. diff --git a/teapots/README.md b/teapots/README.md index e18dc7ca4..3ce29c2df 100644 --- a/teapots/README.md +++ b/teapots/README.md @@ -14,59 +14,6 @@ demonstrate Android NDK platform features: - image-decoder: Same as textured-teapot, except that texture decoding is done 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 ![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. diff --git a/unit-test/README.md b/unit-test/README.md index 0f2da9508..05745fff2 100644 --- a/unit-test/README.md +++ b/unit-test/README.md @@ -109,34 +109,3 @@ Which is: 3 ## Screenshot ![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.