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.

289 lines
17 KiB

  1. #**************************************************************************************************
  2. #
  3. # raylib makefile for Android project (APK building)
  4. #
  5. # Copyright (c) 2017 Ramon Santamaria (@raysan5)
  6. #
  7. # This software is provided "as-is", without any express or implied warranty. In no event
  8. # will the authors be held liable for any damages arising from the use of this software.
  9. #
  10. # Permission is granted to anyone to use this software for any purpose, including commercial
  11. # applications, and to alter it and redistribute it freely, subject to the following restrictions:
  12. #
  13. # 1. The origin of this software must not be misrepresented; you must not claim that you
  14. # wrote the original software. If you use this software in a product, an acknowledgment
  15. # in the product documentation would be appreciated but is not required.
  16. #
  17. # 2. Altered source versions must be plainly marked as such, and must not be misrepresented
  18. # as being the original software.
  19. #
  20. # 3. This notice may not be removed or altered from any source distribution.
  21. #
  22. #**************************************************************************************************
  23. # Define required raylib variables
  24. PLATFORM ?= PLATFORM_ANDROID
  25. RAYLIB_PATH ?= ..\..
  26. # Required path variables
  27. # NOTE: JAVA_HOME must be set to JDK
  28. ANDROID_HOME = C:/android-sdk
  29. ANDROID_NDK = C:/android-ndk
  30. ANDROID_TOOLCHAIN = C:/android_toolchain_arm_api16
  31. ANDROID_BUILD_TOOLS = $(ANDROID_HOME)/build-tools/26.0.2
  32. ANDROID_PLATFORM_TOOLS = $(ANDROID_HOME)/platform-tools
  33. JAVA_HOME = C:/PROGRA~1/Java/jdk1.8.0_144
  34. # Android project configuration variables
  35. PROJECT_NAME ?= raylib_game
  36. PROJECT_LIBRARY_NAME ?= main
  37. PROJECT_BUILD_PATH ?= android.$(PROJECT_NAME)
  38. PROJECT_RESOURCES_PATH ?= resources
  39. PROJECT_SOURCE_FILES ?= raylib_game.c
  40. # Some source files are placed in directories, when compiling to some
  41. # output directory other than source, that directory must pre-exist.
  42. # Here we get a list of required folders that need to be created on
  43. # code output folder $(PROJECT_BUILD_PATH)\obj to avoid GCC errors.
  44. PROJECT_SOURCE_DIRS = $(sort $(dir $(PROJECT_SOURCE_FILES)))
  45. # Android app configuration variables
  46. APP_LABEL_NAME ?= rGame
  47. APP_COMPANY_NAME ?= raylib
  48. APP_PRODUCT_NAME ?= rgame
  49. APP_VERSION_CODE ?= 1
  50. APP_VERSION_NAME ?= 1.0
  51. APP_ICON_LDPI ?= $(RAYLIB_PATH)\logo\logo36x36.png
  52. APP_ICON_MDPI ?= $(RAYLIB_PATH)\logo\logo48x48.png
  53. APP_ICON_HDPI ?= $(RAYLIB_PATH)\logo\logo72x72.png
  54. APP_SCREEN_ORIENTATION ?= landscape
  55. APP_KEYSTORE_PASS ?= raylib
  56. # Library type used for raylib and OpenAL Soft: STATIC (.a) or SHARED (.so/.dll)
  57. RAYLIB_LIBTYPE ?= STATIC
  58. OPENAL_LIBTYPE ?= STATIC
  59. RAYLIB_LIB_PATH = $(RAYLIB_PATH)\release\libs\android\armeabi-v7a
  60. OPENAL_LIB_PATH = $(RAYLIB_PATH)\release\libs\android\armeabi-v7a
  61. # Shared libs must be added to APK if required
  62. # NOTE: Generated NativeLoader.java automatically load those libraries
  63. ifeq ($(RAYLIB_LIBTYPE),SHARED)
  64. PROJECT_SHARED_LIBS = lib/armeabi-v7a/libraylib.so
  65. endif
  66. ifeq ($(OPENAL_LIBTYPE),SHARED)
  67. PROJECT_SHARED_LIBS += lib/armeabi-v7a/libopenal.so
  68. endif
  69. # Compiler and archiver
  70. # NOTE: GCC is being deprectated in Android NDK r16
  71. CC = $(ANDROID_TOOLCHAIN)/bin/arm-linux-androideabi-gcc
  72. AR = $(ANDROID_TOOLCHAIN)/bin/arm-linux-androideabi-ar
  73. # Compiler flags for arquitecture
  74. CFLAGS = -std=c99 -march=armv7-a -mfloat-abi=softfp -mfpu=vfpv3-d16
  75. # Compilation functions attributes options
  76. CFLAGS += -ffunction-sections -funwind-tables -fstack-protector-strong -fPIC
  77. # Compiler options for the linker
  78. CFLAGS += -Wall -Wa,--noexecstack -Wformat -Werror=format-security -no-canonical-prefixes
  79. # Preprocessor macro definitions
  80. CFLAGS += -DANDROID -DPLATFORM_ANDROID -D__ANDROID_API__=16
  81. # Paths containing required header files
  82. INCLUDE_PATHS = -I. -I$(RAYLIB_PATH)/release/include -I$(RAYLIB_PATH)/src/external/android/native_app_glue
  83. # Linker options
  84. LDFLAGS = -Wl,-soname,lib$(PROJECT_LIBRARY_NAME).so -Wl,--exclude-libs,libatomic.a
  85. LDFLAGS += -Wl,--build-id -Wl,--no-undefined -Wl,-z,noexecstack -Wl,-z,relro -Wl,-z,now -Wl,--warn-shared-textrel -Wl,--fatal-warnings
  86. # Force linking of library module to define symbol
  87. LDFLAGS += -u ANativeActivity_onCreate
  88. # Library paths containing required libs
  89. LDFLAGS += -L. -L$(PROJECT_BUILD_PATH)/obj -L$(PROJECT_BUILD_PATH)/lib/armeabi-v7a
  90. # Define any libraries to link into executable
  91. # if you want to link libraries (libname.so or libname.a), use the -lname
  92. LDLIBS = -lraylib -lnative_app_glue -lopenal -llog -landroid -lEGL -lGLESv2 -lOpenSLES -latomic -lc -lm -ldl
  93. # Generate target objects list from PROJECT_SOURCE_FILES
  94. OBJS = $(patsubst %.c, $(PROJECT_BUILD_PATH)/obj/%.o, $(PROJECT_SOURCE_FILES))
  95. # Android APK building process... some steps required...
  96. # NOTE: typing 'make' will invoke the default target entry called 'all',
  97. all: create_temp_project_dirs \
  98. copy_project_required_libs \
  99. copy_project_resources \
  100. generate_loader_script \
  101. generate_android_manifest \
  102. generate_apk_keystore \
  103. config_project_package \
  104. compile_native_app_glue \
  105. compile_project_code \
  106. compile_project_class \
  107. compile_project_class_dex \
  108. create_project_apk_package \
  109. sign_project_apk_package \
  110. zipalign_project_apk_package
  111. # Create required temp directories for APK building
  112. create_temp_project_dirs:
  113. if not exist $(PROJECT_BUILD_PATH) mkdir $(PROJECT_BUILD_PATH)
  114. if not exist $(PROJECT_BUILD_PATH)\obj mkdir $(PROJECT_BUILD_PATH)\obj
  115. if not exist $(PROJECT_BUILD_PATH)\src mkdir $(PROJECT_BUILD_PATH)\src
  116. if not exist $(PROJECT_BUILD_PATH)\src\com mkdir $(PROJECT_BUILD_PATH)\src\com
  117. if not exist $(PROJECT_BUILD_PATH)\src\com\$(APP_COMPANY_NAME) mkdir $(PROJECT_BUILD_PATH)\src\com\$(APP_COMPANY_NAME)
  118. if not exist $(PROJECT_BUILD_PATH)\src\com\$(APP_COMPANY_NAME)\$(APP_PRODUCT_NAME) mkdir $(PROJECT_BUILD_PATH)\src\com\$(APP_COMPANY_NAME)\$(APP_PRODUCT_NAME)
  119. if not exist $(PROJECT_BUILD_PATH)\lib mkdir $(PROJECT_BUILD_PATH)\lib
  120. if not exist $(PROJECT_BUILD_PATH)\lib\armeabi-v7a mkdir $(PROJECT_BUILD_PATH)\lib\armeabi-v7a
  121. if not exist $(PROJECT_BUILD_PATH)\bin mkdir $(PROJECT_BUILD_PATH)\bin
  122. if not exist $(PROJECT_BUILD_PATH)\res mkdir $(PROJECT_BUILD_PATH)\res
  123. if not exist $(PROJECT_BUILD_PATH)\res\drawable-ldpi mkdir $(PROJECT_BUILD_PATH)\res\drawable-ldpi
  124. if not exist $(PROJECT_BUILD_PATH)\res\drawable-mdpi mkdir $(PROJECT_BUILD_PATH)\res\drawable-mdpi
  125. if not exist $(PROJECT_BUILD_PATH)\res\drawable-hdpi mkdir $(PROJECT_BUILD_PATH)\res\drawable-hdpi
  126. if not exist $(PROJECT_BUILD_PATH)\res\values mkdir $(PROJECT_BUILD_PATH)\res\values
  127. if not exist $(PROJECT_BUILD_PATH)\assets mkdir $(PROJECT_BUILD_PATH)\assets
  128. if not exist $(PROJECT_BUILD_PATH)\assets\$(PROJECT_RESOURCES_PATH) mkdir $(PROJECT_BUILD_PATH)\assets\$(PROJECT_RESOURCES_PATH)
  129. if not exist $(PROJECT_BUILD_PATH)\obj\screens mkdir $(PROJECT_BUILD_PATH)\obj\screens
  130. $(foreach dir, $(PROJECT_SOURCE_DIRS), $(call create_dir, $(dir)))
  131. define create_dir
  132. if not exist $(PROJECT_BUILD_PATH)\obj\$(1) mkdir $(PROJECT_BUILD_PATH)\obj\$(1)
  133. endef
  134. # Copy required shared libs for integration into APK
  135. # NOTE: If using shared libs they are loaded by generated NativeLoader.java
  136. copy_project_required_libs:
  137. ifeq ($(RAYLIB_LIBTYPE),SHARED)
  138. copy /Y $(RAYLIB_LIB_PATH)\libraylib.so $(PROJECT_BUILD_PATH)\lib\armeabi-v7a\libraylib.so
  139. endif
  140. ifeq ($(OPENAL_LIBTYPE),SHARED)
  141. copy /Y $(OPENAL_LIB_PATH)\libopenal.so $(PROJECT_BUILD_PATH)\lib\armeabi-v7a\libopenal.so
  142. endif
  143. ifeq ($(RAYLIB_LIBTYPE),STATIC)
  144. copy /Y $(RAYLIB_LIB_PATH)\libraylib.a $(PROJECT_BUILD_PATH)\lib\armeabi-v7a\libraylib.a
  145. endif
  146. ifeq ($(OPENAL_LIBTYPE),STATIC)
  147. copy /Y $(OPENAL_LIB_PATH)\libopenal.a $(PROJECT_BUILD_PATH)\lib\armeabi-v7a\libopenal.a
  148. endif
  149. # Copy project required resources: strings.xml, icon.png, assets
  150. # NOTE: Required strings.xml is generated and game resources are copied to assets folder
  151. # TODO: Review xcopy usage, it can not be found in some systems!
  152. copy_project_resources:
  153. copy $(APP_ICON_LDPI) $(PROJECT_BUILD_PATH)\res\drawable-ldpi\icon.png /Y
  154. copy $(APP_ICON_MDPI) $(PROJECT_BUILD_PATH)\res\drawable-mdpi\icon.png /Y
  155. copy $(APP_ICON_HDPI) $(PROJECT_BUILD_PATH)\res\drawable-hdpi\icon.png /Y
  156. @echo ^<?xml version="1.0" encoding="utf-8"^?^> > $(PROJECT_BUILD_PATH)/res/values/strings.xml
  157. @echo ^<resources^>^<string name="app_name"^>$(APP_LABEL_NAME)^</string^>^</resources^> >> $(PROJECT_BUILD_PATH)/res/values/strings.xml
  158. if exist $(PROJECT_RESOURCES_PATH) C:\Windows\System32\xcopy $(PROJECT_RESOURCES_PATH) $(PROJECT_BUILD_PATH)\assets\$(PROJECT_RESOURCES_PATH) /Y /E /F
  159. # Generate NativeLoader.java to load required shared libraries
  160. # NOTE: Probably not the bet way to generate this file... but it works.
  161. generate_loader_script:
  162. @echo package com.$(APP_COMPANY_NAME).$(APP_PRODUCT_NAME); > $(PROJECT_BUILD_PATH)/src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME)/NativeLoader.java
  163. @echo. >> $(PROJECT_BUILD_PATH)/src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME)/NativeLoader.java
  164. @echo public class NativeLoader extends android.app.NativeActivity { >> $(PROJECT_BUILD_PATH)/src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME)/NativeLoader.java
  165. @echo static { >> $(PROJECT_BUILD_PATH)/src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME)/NativeLoader.java
  166. ifeq ($(OPENAL_LIBTYPE),SHARED)
  167. @echo System.loadLibrary("openal"); >> $(PROJECT_BUILD_PATH)/src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME)/NativeLoader.java
  168. endif
  169. ifeq ($(RAYLIB_LIBTYPE),SHARED)
  170. @echo System.loadLibrary("raylib"); >> $(PROJECT_BUILD_PATH)/src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME)/NativeLoader.java
  171. endif
  172. @echo System.loadLibrary("$(PROJECT_LIBRARY_NAME)"); >> $(PROJECT_BUILD_PATH)/src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME)/NativeLoader.java
  173. @echo } >> $(PROJECT_BUILD_PATH)/src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME)/NativeLoader.java
  174. @echo } >> $(PROJECT_BUILD_PATH)/src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME)/NativeLoader.java
  175. # Generate AndroidManifest.xml with all the required options
  176. # NOTE: Probably not the bet way to generate this file... but it works.
  177. generate_android_manifest:
  178. @echo ^<?xml version="1.0" encoding="utf-8"^?^> > $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  179. @echo ^<manifest xmlns:android="http://schemas.android.com/apk/res/android" >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  180. @echo package="com.$(APP_COMPANY_NAME).$(APP_PRODUCT_NAME)" >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  181. @echo android:versionCode="$(APP_VERSION_CODE)" android:versionName="$(APP_VERSION_NAME)" ^> >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  182. @echo ^<uses-sdk android:minSdkVersion="16" /^> >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  183. @echo ^<uses-feature android:glEsVersion="0x00020000" android:required="true" /^> >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  184. @echo ^<application android:allowBackup="false" android:label="@string/app_name" android:icon="@drawable/icon" ^> >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  185. @echo ^<activity android:name="com.$(APP_COMPANY_NAME).$(APP_PRODUCT_NAME).NativeLoader" >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  186. @echo android:theme="@android:style/Theme.NoTitleBar.Fullscreen" >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  187. @echo android:configChanges="orientation|keyboardHidden|screenSize" >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  188. @echo android:screenOrientation="$(APP_SCREEN_ORIENTATION)" android:launchMode="singleTask" >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  189. @echo android:clearTaskOnLaunch="true"^> >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  190. @echo ^<meta-data android:name="android.app.lib_name" android:value="$(PROJECT_LIBRARY_NAME)" /^> >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  191. @echo ^<intent-filter^> >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  192. @echo ^<action android:name="android.intent.action.MAIN" /^> >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  193. @echo ^<category android:name="android.intent.category.LAUNCHER" /^> >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  194. @echo ^</intent-filter^> >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  195. @echo ^</activity^> >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  196. @echo ^</application^> >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  197. @echo ^</manifest^> >> $(PROJECT_BUILD_PATH)/AndroidManifest.xml
  198. # Generate storekey for APK signing: $(PROJECT_NAME).keystore
  199. # NOTE: Configure here your Distinguished Names (-dname) if required!
  200. generate_apk_keystore:
  201. if not exist $(PROJECT_BUILD_PATH)/$(PROJECT_NAME).keystore $(JAVA_HOME)/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
  202. # Config project package and resource using AndroidManifest.xml and res/values/strings.xml
  203. # NOTE: Generates resources file: src/com/$(APP_COMPANY_NAME)/$(APP_PRODUCT_NAME)/R.java
  204. config_project_package:
  205. $(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-16/android.jar
  206. # Compile native_app_glue code as static library: obj/libnative_app_glue.a
  207. compile_native_app_glue:
  208. $(CC) -c $(RAYLIB_PATH)/src/external/android/native_app_glue/android_native_app_glue.c -o $(PROJECT_BUILD_PATH)/obj/native_app_glue.o $(CFLAGS)
  209. $(AR) rcs $(PROJECT_BUILD_PATH)/obj/libnative_app_glue.a $(PROJECT_BUILD_PATH)/obj/native_app_glue.o
  210. # Compile project code into a shared library: lib/lib$(PROJECT_LIBRARY_NAME).so
  211. compile_project_code: $(OBJS)
  212. $(CC) -o $(PROJECT_BUILD_PATH)/lib/armeabi-v7a/lib$(PROJECT_LIBRARY_NAME).so $(OBJS) -shared $(INCLUDE_PATHS) $(LDFLAGS) $(LDLIBS)
  213. # Compile all .c files required into object (.o) files
  214. # NOTE: Those files will be linked into a shared library
  215. $(PROJECT_BUILD_PATH)/obj/%.o:%.c
  216. $(CC) -c $^ -o $@ $(INCLUDE_PATHS) $(CFLAGS) --sysroot=$(ANDROID_TOOLCHAIN)/sysroot
  217. # Compile project .java code into .class (Java bytecode)
  218. compile_project_class:
  219. $(JAVA_HOME)/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-16/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
  220. # Compile .class files into Dalvik executable bytecode (.dex)
  221. # NOTE: Since Android 5.0, Dalvik interpreter (JIT) has been replaced by ART (AOT)
  222. compile_project_class_dex:
  223. $(ANDROID_BUILD_TOOLS)/dx --verbose --dex --output=$(PROJECT_BUILD_PATH)/bin/classes.dex $(PROJECT_BUILD_PATH)/obj
  224. # Create Android APK package: bin/$(PROJECT_NAME).unsigned.apk
  225. # NOTE: Requires compiled classes.dex and lib$(PROJECT_LIBRARY_NAME).so
  226. # NOTE: Use -A resources to define additional directory in which to find raw asset files
  227. create_project_apk_package:
  228. $(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-16/android.jar -F $(PROJECT_BUILD_PATH)/bin/$(PROJECT_NAME).unsigned.apk $(PROJECT_BUILD_PATH)/bin
  229. cd $(PROJECT_BUILD_PATH) && $(ANDROID_BUILD_TOOLS)/aapt add bin/$(PROJECT_NAME).unsigned.apk lib/armeabi-v7a/lib$(PROJECT_LIBRARY_NAME).so $(PROJECT_SHARED_LIBS)
  230. # Create signed APK package using generated Key: bin/$(PROJECT_NAME).signed.apk
  231. sign_project_apk_package:
  232. $(JAVA_HOME)/bin/jarsigner -keystore $(PROJECT_BUILD_PATH)/$(PROJECT_NAME).keystore -storepass $(APP_KEYSTORE_PASS) -keypass $(APP_KEYSTORE_PASS) -signedjar $(PROJECT_BUILD_PATH)/bin/$(PROJECT_NAME).signed.apk $(PROJECT_BUILD_PATH)/bin/$(PROJECT_NAME).unsigned.apk $(PROJECT_NAME)Key
  233. # Create zip-aligned APK package: $(PROJECT_NAME).apk
  234. zipalign_project_apk_package:
  235. $(ANDROID_BUILD_TOOLS)/zipalign -f 4 $(PROJECT_BUILD_PATH)/bin/$(PROJECT_NAME).signed.apk $(PROJECT_NAME).apk
  236. # Install $(PROJECT_NAME).apk to default emulator/device
  237. # NOTE: Use -e (emulator) or -d (device) parameters if required
  238. install:
  239. $(ANDROID_PLATFORM_TOOLS)/adb install -r $(PROJECT_NAME).apk
  240. # Monitorize output log coming from device, only raylib tag
  241. logcat:
  242. $(ANDROID_PLATFORM_TOOLS)/adb logcat -c
  243. $(ANDROID_PLATFORM_TOOLS)/adb logcat raylib:V *:S
  244. # Install and monitorize $(PROJECT_NAME).apk to default emulator/device
  245. deploy:
  246. $(ANDROID_PLATFORM_TOOLS)/adb install -r $(PROJECT_NAME).apk
  247. $(ANDROID_PLATFORM_TOOLS)/adb logcat -c
  248. $(ANDROID_PLATFORM_TOOLS)/adb logcat raylib:V *:S
  249. #$(ANDROID_PLATFORM_TOOLS)/adb logcat *:W
  250. # Clean everything
  251. clean:
  252. del $(PROJECT_BUILD_PATH)\* /f /s /q
  253. rmdir $(PROJECT_BUILD_PATH) /s /q
  254. @echo Cleaning done