Skip to content

Commit

Permalink
README: Document tested and supported NDK versions (#159)
Browse files Browse the repository at this point in the history
* README: Document tested and supported NDK versions

* README: Remove empty `TODO` headers

While these projects are convenient to be used in conjunction with
android-ndk-rs, it is not required and their section was never filled in
with anything relevant.
  • Loading branch information
MarijnS95 committed Jul 27, 2021
1 parent 2dc644c commit 636e9d9
Showing 1 changed file with 18 additions and 7 deletions.
25 changes: 18 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
# Rust on Android
Rust on Android
=

[![Rust](https://github.com/rust-windowing/android-ndk-rs/workflows/Rust/badge.svg)](https://github.com/rust-windowing/android-ndk-rs/actions) ![MIT license](https://img.shields.io/badge/License-MIT-green.svg) ![APACHE2 license](https://img.shields.io/badge/License-APACHE2-green.svg)

Expand All @@ -14,6 +15,22 @@ Name | Description | Badges

See [`ndk-examples`](./ndk-examples) for examples using the NDK and the README files of the crates for more details.

## Supported NDK versions

`android-ndk-rs` aims to support at least the `LTS` and `Rolling Release` branches of the NDK, as described on [their wiki](https://github.com/android/ndk/wiki#supported-downloads). Additionally the `Beta Release` might be supported to prepare for an upcoming release.

As of writing (2021-07-24) the following NDKs are tested:

Branch | Version | Status | Working
-|-|:-:|:-:
r18 | 18.1.5063045 | _Deprecated_ | :x:
r19 | 19.2.5345600 | _Deprecated_ | :heavy_check_mark:
r20 | 20.1.5948944 | _Deprecated_ | :heavy_check_mark:
r21 | 21.4.7075529 | LTS | :heavy_check_mark:
r22 | 22.1.7171670 | Rolling Release | :heavy_check_mark:
r23 beta 1/2 | | Beta | :heavy_check_mark:
r23 beta 3 and beyond | | Beta | :x: Breaking on [#149](https://github.com/rust-windowing/android-ndk-rs/issues/149) :x:

## Hello world

Quick start for setting up a new project with support for Android. For communication with the Android framework in our native Rust application we require a `NativeActivity`. `ndk-glue` will do the necessary initialization when calling `main` but requires a few adjustments:
Expand Down Expand Up @@ -87,9 +104,3 @@ Java Native Interface (JNI) allows executing Java code in a VM from native appli
`ndk-examples` contains an `jni_audio` example which will print out all output audio devices in the log.

- [`jni`](https://crates.io/crates/jni), JNI bindings for Rust

## Winit and glutin
TODO shameless plug

## Flutter
TODO shameless plug

0 comments on commit 636e9d9

Please sign in to comment.