Merge pull request #4212 from Cacodemon345/patch-11

Fix GitHub display of README-android.md
main
Sylvain Becker 2021-03-20 21:07:32 +01:00 committed by GitHub
commit 599edaaf93
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 19 additions and 38 deletions

View File

@ -10,7 +10,6 @@ If you are using the older ant build process, it is no longer officially
supported, but you can use the "android-project-ant" directory as a template. supported, but you can use the "android-project-ant" directory as a template.
================================================================================
Requirements Requirements
================================================================================ ================================================================================
@ -23,7 +22,6 @@ https://developer.android.com/tools/sdk/ndk/index.html
Minimum API level supported by SDL: 16 (Android 4.1) Minimum API level supported by SDL: 16 (Android 4.1)
================================================================================
How the port works How the port works
================================================================================ ================================================================================
@ -42,7 +40,6 @@ dispatches to native functions implemented in the SDL library:
src/core/android/SDL_android.c src/core/android/SDL_android.c
================================================================================
Building an app Building an app
================================================================================ ================================================================================
@ -120,7 +117,6 @@ Here's an explanation of the files in the Android project, so you can customize
src/main/java/org/libsdl/app/SDLActivity.java - the Java class handling the initialization and binding to SDL. Be very careful changing this, as the SDL library relies on this implementation. You should instead subclass this for your application. src/main/java/org/libsdl/app/SDLActivity.java - the Java class handling the initialization and binding to SDL. Be very careful changing this, as the SDL library relies on this implementation. You should instead subclass this for your application.
================================================================================
Customizing your application name Customizing your application name
================================================================================ ================================================================================
@ -151,7 +147,6 @@ Then replace "SDLActivity" in AndroidManifest.xml with the name of your
class, .e.g. "MyGame" class, .e.g. "MyGame"
================================================================================
Customizing your application icon Customizing your application icon
================================================================================ ================================================================================
@ -160,7 +155,6 @@ the drawable directories under the res directory. There are several directories
for different screen sizes. for different screen sizes.
================================================================================
Loading assets Loading assets
================================================================================ ================================================================================
@ -189,7 +183,6 @@ disable this behaviour, see for example:
http://ponystyle.com/blog/2010/03/26/dealing-with-asset-compression-in-android-apps/ http://ponystyle.com/blog/2010/03/26/dealing-with-asset-compression-in-android-apps/
================================================================================
Pause / Resume behaviour Pause / Resume behaviour
================================================================================ ================================================================================
@ -217,7 +210,6 @@ You should not use the SDL renderer API while the app going in background:
GL context is restored, and the SDL renderer API is available (unless you GL context is restored, and the SDL renderer API is available (unless you
receive SDL_RENDER_DEVICE_RESET). receive SDL_RENDER_DEVICE_RESET).
================================================================================
Mouse / Touch events Mouse / Touch events
================================================================================ ================================================================================
@ -227,7 +219,6 @@ To enable/disable this behavior, see SDL_hints.h:
- SDL_HINT_TOUCH_MOUSE_EVENTS - SDL_HINT_TOUCH_MOUSE_EVENTS
- SDL_HINT_MOUSE_TOUCH_EVENTS - SDL_HINT_MOUSE_TOUCH_EVENTS
================================================================================
Misc Misc
================================================================================ ================================================================================
@ -237,7 +228,6 @@ before creating a window:
SDL_GL_SetAttribute(SDL_GL_GREEN_SIZE, 6); SDL_GL_SetAttribute(SDL_GL_GREEN_SIZE, 6);
SDL_GL_SetAttribute(SDL_GL_BLUE_SIZE, 5); SDL_GL_SetAttribute(SDL_GL_BLUE_SIZE, 5);
================================================================================
Threads and the Java VM Threads and the Java VM
================================================================================ ================================================================================
@ -253,7 +243,6 @@ your thread automatically anyway (when you make an SDL call), but it'll never
detach it. detach it.
================================================================================
Using STL Using STL
================================================================================ ================================================================================
@ -266,7 +255,6 @@ For more information go here:
https://developer.android.com/ndk/guides/cpp-support https://developer.android.com/ndk/guides/cpp-support
================================================================================
Using the emulator Using the emulator
================================================================================ ================================================================================
@ -279,7 +267,6 @@ Notice that this software emulator is incredibly slow and needs a lot of disk sp
Using a real device works better. Using a real device works better.
================================================================================
Troubleshooting Troubleshooting
================================================================================ ================================================================================
@ -359,7 +346,6 @@ If you need to build without optimization turned on, you can create a file calle
APP_OPTIM := debug APP_OPTIM := debug
================================================================================
Memory debugging Memory debugging
================================================================================ ================================================================================
@ -411,7 +397,6 @@ When you're done instrumenting with valgrind, you can disable the wrapper:
adb shell setprop wrap.org.libsdl.app "" adb shell setprop wrap.org.libsdl.app ""
================================================================================
Graphics debugging Graphics debugging
================================================================================ ================================================================================
@ -425,7 +410,6 @@ The Tegra Graphics Debugger is available from NVidia here:
https://developer.nvidia.com/tegra-graphics-debugger https://developer.nvidia.com/tegra-graphics-debugger
================================================================================
Why is API level 16 the minimum required? Why is API level 16 the minimum required?
================================================================================ ================================================================================
@ -435,7 +419,6 @@ about 99% of the Android devices accessing Google Play support API level 16 or
higher (January 2018). higher (January 2018).
================================================================================
A note regarding the use of the "dirty rectangles" rendering technique A note regarding the use of the "dirty rectangles" rendering technique
================================================================================ ================================================================================
@ -454,7 +437,6 @@ screen each frame.
Reference: http://www.khronos.org/registry/egl/specs/EGLTechNote0001.html Reference: http://www.khronos.org/registry/egl/specs/EGLTechNote0001.html
================================================================================
Ending your application Ending your application
================================================================================ ================================================================================
@ -472,7 +454,6 @@ Don't call exit() as it stops the activity badly.
NB: "Back button" can be handled as a SDL_KEYDOWN/UP events, with Keycode NB: "Back button" can be handled as a SDL_KEYDOWN/UP events, with Keycode
SDLK_AC_BACK, for any purpose. SDLK_AC_BACK, for any purpose.
================================================================================
Known issues Known issues
================================================================================ ================================================================================