You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

350 line
17 KiB

  1. #**************************************************************************************************
  2. #
  3. # raylib makefile for Android project (APK building)
  4. #
  5. # NOTE: Ported by Jean-Sébastien Lebarbier (@jseb) to *nix platform.
  6. # For comments, you can contact me: raylib(at)finiderire.com
  7. #
  8. # Copyright (c) 2017-2021 Ramon Santamaria (@raysan5)
  9. #
  10. # This software is provided "as-is", without any express or implied warranty. In no event
  11. # will the authors be held liable for any damages arising from the use of this software.
  12. #
  13. # Permission is granted to anyone to use this software for any purpose, including commercial
  14. # applications, and to alter it and redistribute it freely, subject to the following restrictions:
  15. #
  16. # 1. The origin of this software must not be misrepresented; you must not claim that you
  17. # wrote the original software. If you use this software in a product, an acknowledgment
  18. # in the product documentation would be appreciated but is not required.
  19. #
  20. # 2. Altered source versions must be plainly marked as such, and must not be misrepresented
  21. # as being the original software.
  22. #
  23. # 3. This notice may not be removed or altered from any source distribution.
  24. #
  25. #**************************************************************************************************
  26. # debug : adb logcat *:W | grep -i raylib
  27. # Define required raylib variables
  28. PLATFORM ?= PLATFORM_ANDROID
  29. RAYLIB_PATH ?= ../../
  30. # Define Android architecture (armeabi-v7a, arm64-v8a, x86, x86-64) and API version
  31. # Starting in 2019 using ARM64 is mandatory for published apps,
  32. # Starting on August 2020, minimum required target API is Android 10 (API level 29)
  33. ANDROID_ARCH ?= ARM64
  34. ifeq ($(ANDROID_ARCH),ARM)
  35. ANDROID_ARCH_NAME = armeabi-v7a
  36. # @jseb: Added ANDROID_TOOLCHAIN_LIBS for linking
  37. ANDROID_TOOLCHAIN_LIBS = arm-linux-androideabi
  38. endif
  39. ifeq ($(ANDROID_ARCH),ARM64)
  40. ANDROID_ARCH_NAME = arm64-v8a
  41. # @jseb: Added ANDROID_TOOLCHAIN_LIBS for linking
  42. ANDROID_TOOLCHAIN_LIBS = aarch64-linux-android
  43. endif
  44. # Required path variables
  45. # NOTE: No need to define JAVA_HOME, JAVA_BIN in linux environment (binaries are in $PATH)
  46. #JAVA_HOME ?= C:/JavaJDK/
  47. #JAVA_BIN ?= $(JAVA_HOME)/bin/
  48. ANDROID_HOME ?= /opt/android-sdk
  49. ANDROID_NDK ?= /opt/android-ndk
  50. ANDROID_TOOLCHAIN ?= $(ANDROID_NDK)/toolchains/llvm/prebuilt/linux-x86_64/
  51. # Find the highest version available of build tools
  52. ANDROID_BUILD_TOOLS = $(shell ls -1d $(ANDROID_HOME)/build-tools/* | tail -n 1)/
  53. # and extracts the API version
  54. ANDROID_API_VERSION = $(shell echo $(ANDROID_BUILD_TOOLS) | sed 's/.*\/\([0-9]\+\).*/\1/')
  55. $(warning [*] Using $(ANDROID_BUILD_TOOLS) , API version: $(ANDROID_API_VERSION))
  56. # ANDROID_PLATFORM_TOOLS should be in $PATH too with linux (see /etc/profile.d/android* )
  57. ANDROID_PLATFORM_TOOLS = $(ANDROID_HOME)/platform-tools
  58. # Android project configuration variables
  59. PROJECT_NAME ?= raylib_game
  60. PROJECT_LIBRARY_NAME ?= main
  61. PROJECT_BUILD_ID ?= android
  62. PROJECT_BUILD_PATH ?= $(PROJECT_BUILD_ID).$(PROJECT_NAME)
  63. PROJECT_RESOURCES_PATH ?= resources
  64. PROJECT_SOURCE_FILES ?= simple_game.c
  65. NATIVE_APP_GLUE_PATH = $(ANDROID_NDK)/sources/android/native_app_glue
  66. # Some source files are placed in directories, when compiling to some
  67. # output directory other than source, that directory must pre-exist.
  68. # Here we get a list of required folders that need to be created on
  69. # code output folder $(PROJECT_BUILD_PATH)\obj to avoid GCC errors.
  70. PROJECT_SOURCE_DIRS = $(dir $(PROJECT_SOURCE_FILES))
  71. # Android app configuration variables
  72. APP_LABEL_NAME ?= rGame
  73. APP_COMPANY_NAME ?= raylib
  74. APP_PRODUCT_NAME ?= rgame
  75. APP_VERSION_CODE ?= 1
  76. APP_VERSION_NAME ?= 1.0
  77. APP_ICON_LDPI ?= $(RAYLIB_PATH)/logo/raylib_36x36.png
  78. APP_ICON_MDPI ?= $(RAYLIB_PATH)/logo/raylib_48x48.png
  79. APP_ICON_HDPI ?= $(RAYLIB_PATH)/logo/raylib_72x72.png
  80. APP_SCREEN_ORIENTATION ?= landscape
  81. APP_KEYSTORE_PASS ?= raylib
  82. # Library type used for raylib: STATIC (.a) or SHARED (.so/.dll)
  83. RAYLIB_LIBTYPE ?= STATIC
  84. # Library path for libraylib.a/libraylib.so
  85. RAYLIB_LIB_PATH = $(RAYLIB_PATH)/src/
  86. # Shared libs must be added to APK if required
  87. # NOTE: Generated NativeLoader.java automatically load those libraries
  88. ifeq ($(RAYLIB_LIBTYPE),SHARED)
  89. PROJECT_SHARED_LIBS = lib/$(ANDROID_ARCH_NAME)/libraylib.so
  90. endif
  91. # Compiler and archiver
  92. ifeq ($(ANDROID_ARCH),ARM)
  93. CC = $(ANDROID_TOOLCHAIN)/bin/armv7a-linux-androideabi$(ANDROID_API_VERSION)-clang
  94. AR = $(ANDROID_TOOLCHAIN)/bin/armv7a-linux-androideabi-ar
  95. endif
  96. ifeq ($(ANDROID_ARCH),ARM64)
  97. CC = $(ANDROID_TOOLCHAIN)/bin/aarch64-linux-android$(ANDROID_API_VERSION)-clang
  98. AR = $(ANDROID_TOOLCHAIN)/bin/aarch64-linux-android-ar
  99. endif
  100. ifeq ($(ANDROID_ARCH),x86)
  101. CC = $(ANDROID_TOOLCHAIN)/bin/i686-linux-android$(ANDROID_API_VERSION)-clang
  102. AR = $(ANDROID_TOOLCHAIN)/bin/i686-linux-android-ar
  103. endif
  104. ifeq ($(ANDROID_ARCH),x86_64)
  105. CC = $(ANDROID_TOOLCHAIN)/bin/x86_64-linux-android$(ANDROID_API_VERSION)-clang
  106. AR = $(ANDROID_TOOLCHAIN)/bin/x86_64-linux-android-ar
  107. endif
  108. # Compiler flags for arquitecture
  109. ifeq ($(ANDROID_ARCH),ARM)
  110. CFLAGS = -std=c99 -march=armv7a -mfloat-abi=softfp -mfpu=vfpv3-d16
  111. endif
  112. ifeq ($(ANDROID_ARCH),ARM64)
  113. CFLAGS = -std=c99 -target aarch64 -mfix-cortex-a53-835769
  114. endif
  115. # Compilation functions attributes options
  116. CFLAGS += -ffunction-sections -funwind-tables -fstack-protector-strong -fPIC
  117. # Compiler options for the linker
  118. CFLAGS += -Wall -Wa,--noexecstack -Wformat -Werror=format-security -no-canonical-prefixes
  119. # Preprocessor macro definitions
  120. CFLAGS += -DANDROID -DPLATFORM_ANDROID -D__ANDROID_API__=$(ANDROID_API_VERSION)
  121. # Paths containing required header files
  122. INCLUDE_PATHS = -I. -I$(RAYLIB_PATH)/src -I$(NATIVE_APP_GLUE_PATH)
  123. # Linker options
  124. LDFLAGS = -Wl,-soname,lib$(PROJECT_LIBRARY_NAME).so -Wl,--exclude-libs,libatomic.a
  125. LDFLAGS += -Wl,--build-id -Wl,--no-undefined -Wl,-z,noexecstack -Wl,-z,relro -Wl,-z,now -Wl,--warn-shared-textrel -Wl,--fatal-warnings
  126. # Force linking of library module to define symbol
  127. LDFLAGS += -u ANativeActivity_onCreate
  128. # Library paths containing required libs
  129. LDFLAGS += -L. -L$(PROJECT_BUILD_PATH)/obj -L$(PROJECT_BUILD_PATH)/lib/$(ANDROID_ARCH_NAME)
  130. # Define any libraries to link into executable
  131. # if you want to link libraries (libname.so or libname.a), use the -lname
  132. LDLIBS = -lm -lc -lraylib -llog -landroid -lEGL -lGLESv2 -lOpenSLES -ldl
  133. # Generate target objects list from PROJECT_SOURCE_FILES
  134. OBJS = $(patsubst %.c, $(PROJECT_BUILD_PATH)/obj/%.o, $(PROJECT_SOURCE_FILES))
  135. # Android APK building process... some steps required...
  136. # NOTE: typing 'make' will invoke the default target entry called 'all',
  137. all: create_temp_project_dirs \
  138. copy_project_required_libs \
  139. copy_project_resources \
  140. generate_loader_script \
  141. generate_android_manifest \
  142. generate_apk_keystore \
  143. config_project_package \
  144. compile_project_code \
  145. compile_project_class \
  146. compile_project_class_dex \
  147. create_project_apk_package \
  148. zipalign_project_apk_package \
  149. sign_project_apk_package
  150. # Create required temp directories for APK building
  151. create_temp_project_dirs:
  152. @if [ -d $(PROJECT_BUILD_PATH) ]; then \
  153. echo " [*] directories for $(PROJECT_BUILD_PATH) are already built."; \
  154. else \
  155. echo " [*] creating directories for $(PROJECT_BUILD_PATH)"; \
  156. mkdir -p $(PROJECT_BUILD_PATH)/src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME); \
  157. mkdir -p $(PROJECT_BUILD_PATH)/obj/screens; \
  158. mkdir -p $(PROJECT_BUILD_PATH)/lib/$(ANDROID_ARCH_NAME); \
  159. mkdir -p $(PROJECT_BUILD_PATH)/bin; \
  160. mkdir -p $(PROJECT_BUILD_PATH)/res/drawable-ldpi; \
  161. mkdir -p $(PROJECT_BUILD_PATH)/res/drawable-mdpi; \
  162. mkdir -p $(PROJECT_BUILD_PATH)/res/drawable-hdpi; \
  163. mkdir -p $(PROJECT_BUILD_PATH)/res/values; \
  164. mkdir -p $(PROJECT_BUILD_PATH)/assets/$(PROJECT_RESOURCES_PATH); \
  165. $(foreach dir, $(PROJECT_SOURCE_DIRS), mkdir -p $(PROJECT_BUILD_PATH)/obj/$(dir) ); \
  166. fi
  167. # Copy required shared libs for integration into APK
  168. # NOTE: If using shared libs they are loaded by generated NativeLoader.java
  169. #
  170. # FIXME! Really required to copy libraylib.a, which will be put into exe at link step?
  171. copy_project_required_libs:
  172. cp $(RAYLIB_LIB_PATH)/libraylib.* $(PROJECT_BUILD_PATH)/lib/$(ANDROID_ARCH_NAME)
  173. # Copy project required resources: strings.xml, icon.png, assets
  174. # NOTE: Required strings.xml is generated and game resources are copied to assets folder
  175. copy_project_resources:
  176. cp $(APP_ICON_LDPI) $(PROJECT_BUILD_PATH)/res/drawable-ldpi/icon.png
  177. cp $(APP_ICON_MDPI) $(PROJECT_BUILD_PATH)/res/drawable-mdpi/icon.png
  178. cp $(APP_ICON_HDPI) $(PROJECT_BUILD_PATH)/res/drawable-hdpi/icon.png
  179. @echo "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n\
  180. <resources>\n\
  181. <string name=\"app_name\">\n\
  182. $(APP_LABEL_NAME)\n\
  183. </string>\n\
  184. </resources>" > $(PROJECT_BUILD_PATH)/res/values/strings.xml
  185. @if [ -d $(PROJECT_RESOURCES_PATH) ]; then \
  186. cp -a $(PROJECT_RESOURCES_PATH) $(PROJECT_BUILD_PATH)/assets/; \
  187. else \
  188. echo " [*] Project resources path not found: $(PROJECT_RESOURCES_PATH)"; \
  189. fi
  190. # Generate NativeLoader.java to load required shared libraries
  191. # NOTE: Probably not the bet way to generate this file... but it works.
  192. ifeq ($(RAYLIB_LIBTYPE),SHARED)
  193. nativeloader_sharedlib=System.loadLibrary(\"raylib\")
  194. else
  195. nativeloader_sharedlib=
  196. endif
  197. generate_loader_script:
  198. @echo "package com.$(APP_COMPANY_NAME).$(APP_PRODUCT_NAME);\n\n\
  199. public class NativeLoader extends android.app.NativeActivity {\n\
  200. static {\n\
  201. $(nativeloader_sharedlib);\n\
  202. System.loadLibrary(\"$(PROJECT_LIBRARY_NAME)\");\n\
  203. }\n\
  204. }\n" > $(PROJECT_BUILD_PATH)/src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME)/NativeLoader.java
  205. # Generate AndroidManifest.xml with all the required options
  206. # NOTE: Probably not the bet way to generate this file... but it works.
  207. # TODO @jseb: Replace @drawable/icon with @mipmap/icon?
  208. # https://stackoverflow.com/questions/23796414/error-no-resource-found-that-matches-the-given-name-at-icon-with-value-dr
  209. generate_android_manifest:
  210. @echo "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n\
  211. <manifest xmlns:android=\"http://schemas.android.com/apk/res/android\"\n\
  212. package=\"com.$(APP_COMPANY_NAME).$(APP_PRODUCT_NAME)\"\n\
  213. android:versionCode=\"$(APP_VERSION_CODE)\" android:versionName=\"$(APP_VERSION_NAME)\">\n\
  214. <uses-sdk android:minSdkVersion=\"$(ANDROID_API_VERSION)\" />\n\
  215. <uses-feature android:glEsVersion=\"0x00020000\" android:required=\"true\" />\n\
  216. <application android:allowBackup=\"false\" android:label=\"@string/app_name\" android:icon=\"@drawable/icon\" >\n\
  217. <activity android:name=\"com.$(APP_COMPANY_NAME).$(APP_PRODUCT_NAME).NativeLoader\"\n\
  218. android:theme=\"@android:style/Theme.NoTitleBar.Fullscreen\"\n\
  219. android:configChanges=\"orientation|keyboardHidden|screenSize\"\n\
  220. android:screenOrientation=\"$(APP_SCREEN_ORIENTATION)\" android:launchMode=\"singleTask\"\n\
  221. android:clearTaskOnLaunch=\"true\">\n\
  222. <meta-data android:name=\"android.app.lib_name\" android:value=\"$(PROJECT_LIBRARY_NAME)\" />\n\
  223. <intent-filter>\n\
  224. <action android:name=\"android.intent.action.MAIN\" />\n\
  225. <category android:name=\"android.intent.category.LAUNCHER\" />\n\
  226. </intent-filter>\n\
  227. </activity>\n\
  228. </application>\n\
  229. </manifest>" > $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  230. # Generate storekey for APK signing: $(PROJECT_NAME).keystore
  231. # NOTE: Configure here your Distinguished Names (-dname) if required!
  232. generate_apk_keystore:
  233. # NOTE: https://coderwall.com/p/r09hoq/android-generate-release-debug-keystores
  234. # keytool -genkey -v -keystore debug.keystore -storepass android -alias androiddebugkey -keypass android -keyalg RSA -keysize 2048 -validity 10000
  235. @if [ -s $(PROJECT_BUILD_PATH)/$(PROJECT_NAME).keystore ]; then \
  236. echo " [*] $(PROJECT_NAME).keystore already exists."; \
  237. else \
  238. echo " [*] $(PROJECT_NAME).keystore : generating now."; \
  239. $(JAVA_BIN)keytool -genkeypair -validity 1000 -dname "CN=$(APP_COMPANY_NAME),O=Android,C=ES" -keystore $(PROJECT_BUILD_PATH)/$(PROJECT_NAME).keystore -storepass $(APP_KEYSTORE_PASS) -keypass $(APP_KEYSTORE_PASS) -alias $(PROJECT_NAME)Key -keyalg RSA; \
  240. fi
  241. # Config project package and resource using AndroidManifest.xml and res/values/strings.xml
  242. # NOTE: Generates resources file: src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME)/R.java
  243. config_project_package:
  244. $(ANDROID_BUILD_TOOLS)/aapt package -f -m -S $(PROJECT_BUILD_PATH)/res -J $(PROJECT_BUILD_PATH)/src -M $(PROJECT_BUILD_PATH)/AndroidManifest.xml -I $(ANDROID_HOME)/platforms/android-$(ANDROID_API_VERSION)/android.jar
  245. # Compile native_app_glue code as static library: obj/libnative_app_glue.a
  246. compile_native_app_glue:
  247. $(CC) -c $(NATIVE_APP_GLUE_PATH)/android_native_app_glue.c -o $(PROJECT_BUILD_PATH)/obj/native_app_glue.o $(CFLAGS)
  248. $(AR) rcs $(PROJECT_BUILD_PATH)/obj/libnative_app_glue.a $(PROJECT_BUILD_PATH)/obj/native_app_glue.o
  249. # Compile project code into a shared library: lib/lib$(PROJECT_LIBRARY_NAME).so
  250. compile_project_code: $(OBJS)
  251. $(CC) -o $(PROJECT_BUILD_PATH)/lib/$(ANDROID_ARCH_NAME)/lib$(PROJECT_LIBRARY_NAME).so $(OBJS) -shared $(INCLUDE_PATHS) $(LDFLAGS) $(LDLIBS)
  252. # Compile all .c files required into object (.o) files
  253. # NOTE: Those files will be linked into a shared library
  254. $(PROJECT_BUILD_PATH)/obj/%.o:%.c
  255. $(CC) -c $^ -o $@ $(INCLUDE_PATHS) $(CFLAGS) --sysroot=$(ANDROID_TOOLCHAIN)/sysroot
  256. # Compile project .java code into .class (Java bytecode)
  257. compile_project_class:
  258. $(JAVA_BIN)javac -verbose -source 1.7 -target 1.7 -d $(PROJECT_BUILD_PATH)/obj -bootclasspath $(JAVA_HOME)/jre/lib/rt.jar -classpath $(ANDROID_HOME)/platforms/android-$(ANDROID_API_VERSION)/android.jar:$(PROJECT_BUILD_PATH)/obj -sourcepath $(PROJECT_BUILD_PATH)/src $(PROJECT_BUILD_PATH)/src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME)/R.java $(PROJECT_BUILD_PATH)/src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME)/NativeLoader.java
  259. # Compile .class files into Dalvik executable bytecode (.dex)
  260. # NOTE: Since Android 5.0, Dalvik interpreter (JIT) has been replaced by ART (AOT)
  261. compile_project_class_dex:
  262. $(ANDROID_BUILD_TOOLS)/dx --verbose --dex --output=$(PROJECT_BUILD_PATH)/bin/classes.dex $(PROJECT_BUILD_PATH)/obj
  263. # Create Android APK package: bin/$(PROJECT_NAME).unsigned.apk
  264. # NOTE: Requires compiled classes.dex and lib$(PROJECT_LIBRARY_NAME).so
  265. # NOTE: Use -A resources to define additional directory in which to find raw asset files
  266. create_project_apk_package:
  267. $(ANDROID_BUILD_TOOLS)/aapt package -f -M $(PROJECT_BUILD_PATH)/AndroidManifest.xml -S $(PROJECT_BUILD_PATH)/res -A $(PROJECT_BUILD_PATH)/assets -I $(ANDROID_HOME)/platforms/android-$(ANDROID_API_VERSION)/android.jar -F $(PROJECT_BUILD_PATH)/bin/$(PROJECT_NAME).unsigned.apk $(PROJECT_BUILD_PATH)/bin
  268. cd $(PROJECT_BUILD_PATH) && $(ANDROID_BUILD_TOOLS)/aapt add bin/$(PROJECT_NAME).unsigned.apk lib/$(ANDROID_ARCH_NAME)/lib$(PROJECT_LIBRARY_NAME).so $(PROJECT_SHARED_LIBS)
  269. # Create signed APK package using generated Key: bin/$(PROJECT_NAME).signed.apk
  270. sign_project_apk_package:
  271. #keytool -genkey -v -keystore debug.keystore -storepass android -alias androiddebugkey -keypass android -keyalg RSA -keysize 2048 -validity 10000
  272. $(ANDROID_BUILD_TOOLS)/apksigner sign --ks $(PROJECT_BUILD_PATH)/$(PROJECT_NAME).keystore --ks-pass pass:$(APP_KEYSTORE_PASS) --out $(PROJECT_BUILD_PATH)/bin/$(PROJECT_NAME).signed.apk $(PROJECT_BUILD_PATH)/bin/$(PROJECT_NAME).zipaligned.apk
  273. rm $(PROJECT_BUILD_PATH)/bin/$(PROJECT_NAME).zipaligned.apk
  274. # Create zip-aligned APK package: $(PROJECT_NAME).apk
  275. zipalign_project_apk_package:
  276. $(ANDROID_BUILD_TOOLS)/zipalign -f 4 $(PROJECT_BUILD_PATH)/bin/$(PROJECT_NAME).unsigned.apk $(PROJECT_BUILD_PATH)/bin/$(PROJECT_NAME).zipaligned.apk
  277. rm $(PROJECT_BUILD_PATH)/bin/$(PROJECT_NAME).unsigned.apk
  278. # Install $(PROJECT_NAME).apk to default emulator/device
  279. # NOTE: Use -e (emulator) or -d (device) parameters if required
  280. install:
  281. $(ANDROID_PLATFORM_TOOLS)/adb install --abi $(ANDROID_ARCH_NAME) -rds $(PROJECT_NAME).apk
  282. # Check supported ABI for the device (armeabi-v7a, arm64-v8a, x86, x86_64)
  283. check_device_abi:
  284. $(ANDROID_PLATFORM_TOOLS)/adb shell getprop ro.product.cpu.abi
  285. # Monitorize output log coming from device, only raylib tag
  286. logcat:
  287. $(ANDROID_PLATFORM_TOOLS)/adb logcat -c
  288. $(ANDROID_PLATFORM_TOOLS)/adb logcat raylib:V *:S
  289. # Install and monitorize $(PROJECT_NAME).apk to default emulator/device
  290. deploy:
  291. $(ANDROID_PLATFORM_TOOLS)/adb install -r $(PROJECT_NAME).apk
  292. $(ANDROID_PLATFORM_TOOLS)/adb logcat -c
  293. $(ANDROID_PLATFORM_TOOLS)/adb logcat raylib:V *:S
  294. #$(ANDROID_PLATFORM_TOOLS)/adb logcat *:W
  295. # @jseb: Clean everything, but avoid accidental removing of root dir, or $HOME, or whatever important
  296. clean:
  297. @if [ "$(shell echo $(PROJECT_BUILD_PATH) | grep "$(PROJECT_BUILD_ID)")" != "" ]; then \
  298. rm -rf $(PROJECT_BUILD_PATH); \
  299. echo Cleaning done; \
  300. else \
  301. echo "Error ! Project name ($(PROJECT_BUILD_PATH)) must contains this string : $(PROJECT_BUILD_ID)"; \
  302. fi