Merge pull request #16 from andyque/testScripts

finish linux,ios,mac,android,tizen

Author: ricardoquesada

README.md

@@ -27,15 +27,15 @@ or Windows machine were not tested, so we don't know if it works or not.
 
 ## Prerequisite
 ### For Mac users
-- If you want to use these scripts, you should install Git 1.8+, CMake 2.8+ and M4 1.4+.
+- If you want to use these scripts, you should install Git 1.8+, CMake 2.8+, autoconf and libtool.
 If you are a Homebrew user, you could simply run the following commands to install these tools:
 
 ```
 brew update
 brew install git
 brew install cmake
-brew install m4
 brew install autoconf
+brew install libtool
 ```
 
 - If you want to build static libraries for iOS and Mac, you should install the latest version of XCode.  You should also install the `Command Line Tools` bundled with XCode.
@@ -45,22 +45,24 @@ brew install autoconf
 
 - If you want to build static libraries for Tizen, you should download and install [Tizen SDK](https://developer.tizen.org/downloads/tizen-sdk). And you should also add a environment variable named `TIZEN_SDK` in your shell.
 
-### For Linux users
-xxx need to improve the document here later.
+### For Linux(Ubuntu) users
+- If you want to use these scripts, you should instll *autoconf*:
+
+```
+sudo apt-get install autoconf
+sudo apt-get install cmake
+sudo apt-get install libtool
+sudo apt-get install git
+```
 
 ### For Windows users
 In order to run these scripts, you should install [msys2](http://msys2.github.io/) and update the system packages.
 
 After that, you should also install the following dependencies:
 
 ```
-pacman -S gcc
-pacman -S make
-pacman -S autoconf
-pacman -S automake
-pacman -S git
-pacman -S cmake
-pacman -S libtool
+pacman -S mingw-w64-i686-toolchain
+
 ```
 
 ## How to use
@@ -69,9 +71,11 @@ We have one build script for each platform, they are under `build/platform{ios/m
 All of them share the same usage:
 
 ```
-./build.sh --libs=param1 --arch=param2 --mode=param3 --list
+./build.sh -p=param0 --libs=param1 --arch=param2 --mode=param3 --list
 ```
 
+- param0: specify a platform, only (ios, mac, android, linux and tizen ) are valid values.
+
 - param1:
     - use `all` to build all the 3rd party libraries, it will take you a very long time.
     - use comma separated library names, for example, `png,lua,jpeg,webp`,  no space between the comma.
@@ -87,12 +91,12 @@ All of them share the same usage:
 - list:
     - Use these option to list all the supported libraries.
 
-### For iOS Platform
+### Build png on iOS platform
 For building libpng fat library with all arch x86_64, i386, armv7, arm64 on release mode:
 
 ```
-cd build/ios
-./build.sh --libs=png
+cd build
+./build.sh -p=ios --libs=png
 ```
 
 After running this command, it will generate a folder named `png`:
@@ -110,24 +114,24 @@ All the other libraries share the same folder structure.
 For building libpng fat library with arch armv7 and arm64 on debug mode:
 
 ```
-cd build/ios
-./build.sh --libs=png --arch=armv7,arm64 --mode=debug
+cd build
+./build.sh -p=ios --libs=png --arch=armv7,arm64 --mode=debug
 ```
 
-### For Android Platform
-xxx document will be update later.
+### Build for Android arm64
+
+1. Download Android NDK r10c and set the ANDROID_NDK to point to the Android ndk r10c path. Don't forget to `source ~/.bash_profile`.
+
+2. Modify the android.ini config file. Change `cfg_default_build_api=21` and `cfg_default_gcc_version=4.9`.
+
+3. Pass `--arch=64` to build the libraries with arm64 support.
 
-### For Mac
-xxx document will be update later.
 
-### For Tizen
-xxx document will be update later.
+For other platforms and other libraries, it is more or less the same way except for some minor changes in `--arch` parameter and `-p` parameter.
 
-### For Linux
-xxx After testing these scripts on Linux, document will be update.
 
 ## How to build a DEBUG and RELEASE version
-xxx we need to improve the script to add debug and release options.
+You can add flag "--mode=[debug | release]" for building DEBUG and RELEASE version.
 
 ## How to do build clean?
 If you use `./build.sh` to build static libraries, there is no need to do clean. After generating the static library, script will delete the intermediate files.

build/android.ini

@@ -0,0 +1,43 @@
+cfg_platform_name=android
+#default values put it here
+cfg_default_build_arches="all"
+cfg_default_build_mode="release"
+cfg_default_build_libraries="all"
+#specific default values
+cfg_default_build_api=19
+cfg_default_gcc_version=4.8
+
+#help message strings goes here
+cfg_help_arch_string="arm,armv7,x86,arm64"
+cfg_help_sample_string="./build.sh -p=android --libs=png --arch=arm,armv7,arm64 --mode=debug"
+
+#build machine & build host
+cfg_build_machine="x86_64-apple-darwin14"
+cfg_x86_host_machine="i686-linux-android"
+cfg_arm64_host_machine="aarch64-linux-android"
+cfg_arm_host_machine="arm-linux-androideabi"
+cfg_armv7_host_machine="arm-linux-androideabi"
+
+#only cross compile should define thse variables
+cfg_is_cross_compile=yes
+
+cfg_x86_toolchain_bin="${ANDROID_NDK}/toolchains/x86-${cfg_default_gcc_version}/prebuilt/darwin-x86_64/bin"
+cfg_arm64_toolchain_bin="${ANDROID_NDK}/toolchains/aarch64-linux-android-${cfg_default_gcc_version}/prebuilt/darwin-x86_64/bin"
+cfg_arm_toolchain_bin="${ANDROID_NDK}/toolchains/arm-linux-androideabi-${cfg_default_gcc_version}/prebuilt/darwin-x86_64/bin"
+cfg_armv7_toolchain_bin="${ANDROID_NDK}/toolchains/arm-linux-androideabi-${cfg_default_gcc_version}/prebuilt/darwin-x86_64/bin"
+
+
+#build arches and build libraries
+cfg_all_supported_arches=("arm" "armv7" "x86" "arm64")
+cfg_all_supported_libraries=("png" "zlib" "lua" "luajit" "websockets" "curl" "freetype" "jpeg"  "tiff" "webp" "chipmunk" "openssl")
+cfg_default_arches_all=("arm" "armv7" "x86" "arm64")
+cfg_default_libraries_all=("png" "zlib" "lua" "luajit" "websockets" "curl" "freetype" "jpeg" "tiff" "webp" "chipmunk" "openssl")
+
+
+#whether build fat library, use lipo -S create
+cfg_build_fat_library=no
+
+#debug and release mode flag
+cfg_build_release_mode="-O3 -DNDEBUG"
+cfg_build_debug_mode="-O0 -g -DDEBUG"
+