docs/README-android.md
changeset 11649 fe6769530709
parent 11647 5816b27073a4
child 11659 b2fd0f264cd3
equal deleted inserted replaced
11648:ed5bc0abae1b 11649:fe6769530709
    12 ================================================================================
    12 ================================================================================
    13 
    13 
    14 Android SDK (version 16 or later)
    14 Android SDK (version 16 or later)
    15 https://developer.android.com/sdk/index.html
    15 https://developer.android.com/sdk/index.html
    16 
    16 
    17 Android NDK r7 or later
    17 Android NDK r10e or later
    18 https://developer.android.com/tools/sdk/ndk/index.html
    18 https://developer.android.com/tools/sdk/ndk/index.html
    19 
    19 
    20 Minimum API level supported by SDL: 10 (Android 2.3.3)
    20 Minimum API level supported by SDL: 14 (Android 4.0.1)
    21 Joystick support is available for API level >= 12 devices.
       
    22 
    21 
    23 
    22 
    24 ================================================================================
    23 ================================================================================
    25  How the port works
    24  How the port works
    26 ================================================================================
    25 ================================================================================
   391 The Tegra Graphics Debugger is available from NVidia here:
   390 The Tegra Graphics Debugger is available from NVidia here:
   392 https://developer.nvidia.com/tegra-graphics-debugger
   391 https://developer.nvidia.com/tegra-graphics-debugger
   393 
   392 
   394 
   393 
   395 ================================================================================
   394 ================================================================================
   396  Why is API level 10 the minimum required?
   395  Why is API level 14 the minimum required?
   397 ================================================================================
   396 ================================================================================
   398 
   397 
   399 API level 10 is the minimum required level at runtime (that is, on the device) 
   398 The latest NDK toolchain doesn't support targeting earlier than API level 14.
   400 because SDL requires some functionality for running not
       
   401 available on older devices. Since the incorporation of joystick support into SDL,
       
   402 the minimum SDK required to *build* SDL is version 16. Devices running API levels
       
   403 10-11 are still supported, only with the joystick functionality disabled.
       
   404 
       
   405 Support for native OpenGL ES and ES2 applications was introduced in the NDK for
       
   406 API level 4 and 8. EGL was made a stable API in the NDK for API level 9, which
       
   407 has since then been obsoleted, with the recommendation to developers to bump the
       
   408 required API level to 10.
       
   409 As of this writing, according to https://developer.android.com/about/dashboards/index.html
   399 As of this writing, according to https://developer.android.com/about/dashboards/index.html
   410 about 90% of the Android devices accessing Google Play support API level 10 or
   400 about 99% of the Android devices accessing Google Play support API level 14 or
   411 higher (March 2013).
   401 higher (October 2017).
   412 
   402 
   413 
   403 
   414 ================================================================================
   404 ================================================================================
   415  A note regarding the use of the "dirty rectangles" rendering technique
   405  A note regarding the use of the "dirty rectangles" rendering technique
   416 ================================================================================
   406 ================================================================================