android/ndk-samples
1
0
Fork 0
mirror of https://github.com/android/ndk-samples synced 2025-11-04 06:15:39 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
5dd0e384fe9436ea270d17472f0f9da733f97992
ndk-samples/native-activity/README.md
Dan Albert fa71ca4019 Update the native-activity README. 
I changed what this sample does but forgot to update the docs.
2025-09-17 23:11:18 +00:00

2.9 KiB
Raw Blame History

Native Activity

This is an Android sample that uses NativeActivity with native_app_glue, which enables building NDK apps without having to write any Java code. In practice most apps, even games which are predominantly native code, will need to call some Java APIs or customize their app's activity further.

The more modern approach to this is to use GameActivity, which has all the same benefits as NativeActivity and native_app_glue, while also making it easier to include Java code in your app without a rewrite later. It's also source compatible. This sample will likely migrate to GameActivity in the future.

The app here is intentionally quite simple, aiming to show the core event and draw loop necessary for an app using native_app_glue without any extra clutter. It uses AChoreographer to manage the update/render loop, and uses ANativeWindow and AHardwareBuffer to update the screen with a simple color clear.

This sample uses the new Android Studio CMake plugin with C++ support.

Pre-requisites

  • Android Studio 2.2+ with NDK bundle.

Getting Started

  1. Download Android Studio
  2. Launch Android Studio.
  3. Open the sample directory.
  4. Open File/Project Structure...
  • Click Download or Select NDK location.
  1. Click Tools/Android/Sync Project with Gradle Files.
  2. Click Run/Run 'app'.

Screenshots

screenshot

Support

If you've found an error in these samples, please file an issue.

Patches are encouraged, and may be submitted by forking this project and submitting a pull request through GitHub. Please see CONTRIBUTING.md for more details.

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.