src/platform/android.nit

   1 # This file is part of NIT ( http://www.nitlanguage.org ).
   2 #
   3 # Copyright 2014 Alexis Laferrière <alexis.laf@xymus.net>
   4 #
   5 # Licensed under the Apache License, Version 2.0 (the "License");
   6 # you may not use this file except in compliance with the License.
   7 # You may obtain a copy of the License at
   8 #
   9 #     http://www.apache.org/licenses/LICENSE-2.0
  10 #
  11 # Unless required by applicable law or agreed to in writing, software
  12 # distributed under the License is distributed on an "AS IS" BASIS,
  13 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14 # See the License for the specific language governing permissions and
  15 # limitations under the License.
  16
  17 # Compile program for the Android platform
  18 module android
  19
  20 import platform
  21 import compiler::abstract_compiler
  22 import ffi
  23 intrude import ffi::extra_java_files
  24 import android_annotations
  25
  26 redef class ToolContext
  27         redef fun platform_from_name(name)
  28         do
  29                 if name == "android" then return new AndroidPlatform
  30                 return super
  31         end
  32 end
  33
  34 class AndroidPlatform
  35         super Platform
  36
  37         redef fun name do return "android"
  38
  39         redef fun supports_libgc do return true
  40
  41         redef fun supports_libunwind do return false
  42
  43         redef fun supports_linker_script do return false
  44
  45         redef fun toolchain(toolcontext, compiler) do return new AndroidToolchain(toolcontext, compiler)
  46 end
  47
  48 class AndroidToolchain
  49         super MakefileToolchain
  50
  51         var android_project_root: nullable String = null
  52
  53         redef fun compile_dir
  54         do
  55                 var android_project_root = "{root_compile_dir}/android/"
  56                 self.android_project_root = android_project_root
  57                 return "{android_project_root}/jni/nit_compile/"
  58         end
  59
  60         redef fun default_outname do return "{super}.apk"
  61
  62         redef fun write_files(compile_dir, cfiles)
  63         do
  64                 var android_project_root = android_project_root.as(not null)
  65                 var project = new AndroidProject(toolcontext.modelbuilder, compiler.mainmodule)
  66                 var release = toolcontext.opt_release.value
  67
  68                 var app_name = project.name
  69                 if not release then app_name += " Debug"
  70
  71                 var short_project_name = project.short_name
  72
  73                 var app_package = project.namespace
  74                 if not release then app_package += "_debug"
  75
  76                 var app_version = project.version
  77
  78                 var app_min_api = project.min_api
  79                 if app_min_api == null then app_min_api = 10
  80
  81                 var app_target_api = project.target_api
  82                 if app_target_api == null then app_target_api = app_min_api
  83
  84                 var app_max_api = ""
  85                 if project.max_api != null then app_max_api = "android:maxSdkVersion=\"{project.max_api.as(not null)}\""
  86
  87                 # Clear the previous android project, so there is no "existing project warning"
  88                 # or conflict between Java files of different projects
  89                 if android_project_root.file_exists then android_project_root.rmdir
  90
  91                 var args = ["android", "-s",
  92                         "create", "project",
  93                         "--name", short_project_name,
  94                         "--target", "android-{app_target_api}",
  95                         "--path", android_project_root,
  96                         "--package", app_package,
  97                         "--activity", short_project_name]
  98                 toolcontext.exec_and_check(args, "Android project error")
  99
 100                 # create compile_dir
 101                 var dir = "{android_project_root}/jni/"
 102                 if not dir.file_exists then dir.mkdir
 103
 104                 dir = compile_dir
 105                 if not dir.file_exists then dir.mkdir
 106
 107                 # compile normal C files
 108                 super
 109
 110                 # Gather extra C files generated elsewhere than in super
 111                 for f in compiler.extern_bodies do
 112                         if f isa ExternCFile then cfiles.add(f.filename.basename)
 113                 end
 114
 115                 # Is there an icon?
 116                 var resolutions = ["ldpi", "mdpi", "hdpi", "xhdpi", "xxhdpi", "xxxhdpi"]
 117                 var icon_available = false
 118                 for res in resolutions do
 119                         var path = "res/drawable-{res}/icon.png"
 120                         if path.file_exists then
 121                                 icon_available = true
 122                                 break
 123                         end
 124                 end
 125
 126                 var icon_declaration
 127                 if icon_available then
 128                         icon_declaration = "android:icon=\"@drawable/icon\""
 129                 else icon_declaration = ""
 130
 131                 # Also copy over the java files
 132                 dir = "{android_project_root}/src/"
 133                 for mmodule in compiler.mainmodule.in_importation.greaters do
 134                         var extra_java_files = mmodule.extra_java_files
 135                         if extra_java_files != null then for file in extra_java_files do
 136                                 var path = file.filename
 137                                 path.file_copy_to(dir/path.basename)
 138                         end
 139                 end
 140
 141                 ## Generate Application.mk
 142                 dir = "{android_project_root}/jni/"
 143                 """
 144 APP_ABI := armeabi armeabi-v7a x86 mips
 145 APP_PLATFORM := android-{{{app_target_api}}}
 146 """.write_to_file "{dir}/Application.mk"
 147
 148                 ## Generate delegating makefile
 149                 """
 150 include $(call all-subdir-makefiles)
 151 """.write_to_file "{dir}/Android.mk"
 152
 153                 # Gather ldflags for Android
 154                 var ldflags = new Array[String]
 155                 var platform_name = "android"
 156                 for mmodule in compiler.mainmodule.in_importation.greaters do
 157                         if mmodule.ldflags.keys.has(platform_name) then
 158                                 ldflags.add_all mmodule.ldflags[platform_name]
 159                         end
 160                 end
 161
 162                 ### generate makefile into "{compile_dir}/Android.mk"
 163                 dir = compile_dir
 164                 """
 165 LOCAL_PATH := $(call my-dir)
 166 include $(CLEAR_VARS)
 167
 168 LOCAL_CFLAGS    := -D ANDROID -D WITH_LIBGC
 169 LOCAL_MODULE    := main
 170 LOCAL_SRC_FILES := \\
 171 {{{cfiles.join(" \\\n")}}}
 172 LOCAL_LDLIBS    := {{{ldflags.join(" ")}}} $(TARGET_ARCH)/libgc.a
 173 LOCAL_STATIC_LIBRARIES := android_native_app_glue png
 174
 175 include $(BUILD_SHARED_LIBRARY)
 176
 177 $(call import-module,android/native_app_glue)
 178                 """.write_to_file("{dir}/Android.mk")
 179
 180                 ### generate AndroidManifest.xml
 181                 dir = android_project_root
 182                 var manifest_file = new FileWriter.open("{dir}/AndroidManifest.xml")
 183                 manifest_file.write """
 184 <?xml version="1.0" encoding="utf-8"?>
 185 <!-- BEGIN_INCLUDE(manifest) -->
 186 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
 187         package="{{{app_package}}}"
 188         android:versionCode="{{{project.version_code}}}"
 189         android:versionName="{{{app_version}}}">
 190
 191     <uses-sdk
 192         android:minSdkVersion="{{{app_min_api}}}"
 193         android:targetSdkVersion="{{{app_target_api}}}"
 194         {{{app_max_api}}} />
 195
 196     <application
 197                 android:label="@string/app_name"
 198                 android:hasCode="true"
 199                 android:debuggable="{{{not release}}}"
 200                 {{{icon_declaration}}}>
 201 """
 202
 203                 for activity in project.activities do
 204                         manifest_file.write """
 205         <activity android:name="{{{activity}}}"
 206                 android:label="@string/app_name"
 207                 {{{project.manifest_activity_attributes.join("\n")}}}
 208                 {{{icon_declaration}}}>
 209             <intent-filter>
 210                 <action android:name="android.intent.action.MAIN" />
 211                 <category android:name="android.intent.category.LAUNCHER" />
 212             </intent-filter>
 213         </activity>
 214 """
 215                 end
 216
 217                 manifest_file.write """
 218 {{{project.manifest_application_lines.join("\n")}}}
 219
 220     </application>
 221
 222 {{{project.manifest_lines.join("\n")}}}
 223
 224 </manifest>
 225 <!-- END_INCLUDE(manifest) -->
 226 """
 227                 manifest_file.close
 228
 229                 ### Link to png sources
 230                 # libpng is not available on Android NDK
 231                 # FIXME make obtionnal when we have alternatives to mnit
 232                 var nit_dir = toolcontext.nit_dir
 233                 var share_dir =  nit_dir/"share/"
 234                 if not share_dir.file_exists then
 235                         print "Android project error: Nit share directory not found, please use the environment variable NIT_DIR"
 236                         exit 1
 237                 end
 238                 share_dir = share_dir.realpath
 239                 var target_png_dir = "{android_project_root}/jni/png"
 240                 if not target_png_dir.file_exists then
 241                         toolcontext.exec_and_check(["ln", "-s", "{share_dir}/png/", target_png_dir], "Android project error")
 242                 end
 243
 244                 # Ensure that android-setup-libgc.sh has been executed
 245                 if not "{share_dir}/libgc/arm/lib".file_exists then
 246                         toolcontext.exec_and_check(["{share_dir}/libgc/android-setup-libgc.sh"], "Android project error")
 247                 end
 248
 249                 # Copy GC files
 250                 for arch in ["arm", "x86", "mips"] do
 251                         dir = android_project_root/arch
 252                         dir.mkdir
 253                         toolcontext.exec_and_check(["cp", "{share_dir}/libgc/{arch}/lib/libgc.a",
 254                                 dir/"libgc.a"], "Android project error")
 255                 end
 256
 257                 toolcontext.exec_and_check(["ln", "-s", "{share_dir}/libgc/arm/include/gc/",
 258                         "{compile_dir}/gc"], "Android project error")
 259
 260                 # Copy assets, resources and libs where expected by the SDK
 261
 262                 var project_root = "."
 263                 var mproject = compiler.mainmodule.first_real_mmodule.mproject
 264                 if mproject != null then
 265                         var root = mproject.root
 266                         if root != null then
 267                                 var filepath = root.filepath
 268                                 if filepath != null then
 269                                         project_root = filepath
 270                                 end
 271                         end
 272                 end
 273
 274                 # Link to assets (for mnit and others)
 275                 var assets_dir = project_root / "assets"
 276                 if assets_dir.file_exists then
 277                         assets_dir = assets_dir.realpath
 278                         var target_assets_dir = "{android_project_root}/assets"
 279                         if not target_assets_dir.file_exists then
 280                                 toolcontext.exec_and_check(["ln", "-s", assets_dir, target_assets_dir], "Android project error")
 281                         end
 282                 end
 283
 284                 # Copy the res folder
 285                 var res_dir = project_root / "res"
 286                 if res_dir.file_exists then
 287                         # copy the res folder to the compile dir
 288                         res_dir = res_dir.realpath
 289                         toolcontext.exec_and_check(["cp", "-R", res_dir, android_project_root], "Android project error")
 290                 end
 291
 292                 if not res_dir.file_exists or not "{res_dir}/values/strings.xml".file_exists then
 293                         # Create our own custom `res/values/string.xml` with the App name
 294 """<?xml version="1.0" encoding="utf-8"?>
 295 <resources>
 296     <string name="app_name">{{{app_name}}}</string>
 297 </resources>""".write_to_file "{android_project_root}/res/values/strings.xml"
 298                 end
 299
 300                 # Copy the libs folder
 301                 var libs_dir = project_root / "libs"
 302                 if libs_dir.file_exists then
 303                         toolcontext.exec_and_check(["cp", "-r", libs_dir, android_project_root], "Android project error")
 304                 end
 305         end
 306
 307         redef fun write_makefile(compile_dir, cfiles)
 308         do
 309                 # Do nothing, already done in `write_files`
 310         end
 311
 312         redef fun compile_c_code(compile_dir)
 313         do
 314                 var android_project_root = android_project_root.as(not null)
 315                 var short_project_name = compiler.mainmodule.name.replace("-", "_")
 316                 var release = toolcontext.opt_release.value
 317
 318                 # Compile C code (and thus Nit)
 319                 toolcontext.exec_and_check(["ndk-build", "-s", "-j", "-C", android_project_root], "Android project error")
 320
 321                 # Generate the apk
 322                 var args = ["ant", "-q", "-f", android_project_root+"/build.xml"]
 323                 if release then
 324                         args.add "release"
 325                 else args.add "debug"
 326                 toolcontext.exec_and_check(args, "Android project error")
 327
 328                 # Move the apk to the target
 329                 var outname = outfile(compiler.mainmodule)
 330
 331                 if release then
 332                         var apk_path = "{android_project_root}/bin/{short_project_name}-release-unsigned.apk"
 333
 334                         # Sign APK
 335                         var keystore_path= "KEYSTORE".environ
 336                         var key_alias= "KEY_ALIAS".environ
 337                         var tsa_server= "TSA_SERVER".environ
 338
 339                         if key_alias.is_empty then
 340                                 toolcontext.error(null,
 341                                         "Error: the environment variable `KEY_ALIAS` must be set to use the `--release` option on Android projects.")
 342                                 return
 343                         end
 344
 345                         args = ["jarsigner", "-sigalg", "MD5withRSA", "-digestalg", "SHA1", apk_path, key_alias]
 346
 347                         ## Use a custom keystore
 348                         if not keystore_path.is_empty then args.add_all(["-keystore", keystore_path])
 349
 350                         ## Use a TSA server
 351                         if not tsa_server.is_empty then args.add_all(["-tsa", tsa_server])
 352
 353                         toolcontext.exec_and_check(args, "Android project error")
 354
 355                         # Clean output file
 356                         if outname.to_path.exists then outname.to_path.delete
 357
 358                         # Align APK
 359                         args = ["zipalign", "4", apk_path, outname]
 360                         toolcontext.exec_and_check(args, "Android project error")
 361                 else
 362                         # Move to the expected output path
 363                         args = ["mv", "{android_project_root}/bin/{short_project_name}-debug.apk", outname]
 364                         toolcontext.exec_and_check(args, "Android project error")
 365                 end
 366         end
 367 end
 368
 369 redef class JavaClassTemplate
 370         redef fun write_to_files(compdir)
 371         do
 372                 var jni_path = "jni/nit_compile/"
 373                 if compdir.has_suffix(jni_path) then
 374                         var path = "{compdir.substring(0, compdir.length-jni_path.length)}/src/"
 375                         return super(path)
 376                 else return super
 377         end
 378 end