Skip to content

Latest commit

 

History

History
141 lines (141 loc) · 6.04 KB

README.md

File metadata and controls

141 lines (141 loc) · 6.04 KB
Raw

simple-build-ios-and-android-script

1. Documentation

Introduction

A common build project for building mobile platform native libraries.

Target users

Mobile platform C&&C++ native library.

Build target library list:

id name version dependent libraries note
1 openssl 1.1.1d - Configure is perl script
2 nghttp2 1.40.0 - -
3 curl 7.68.0 openssl,nghttp2 -
3 protobuf 3.11.4 - -

iOS Platform static library(.a) support list:

id armv7 armv7s arm64 arm64e x86 x86-64 note
1 yes no yes yes no yes -
2 yes no yes yes no yes -
3 yes no yes yes no yes -
4 yes no yes yes no yes -

iOS Platform dynamic library(.dylib) support list:

TODO:

iOS Platform static framework(.framework) support list:

TODO:

iOS Platform dynamic framework(.framework) support list:

TODO:

Android Platform static library(.a) support list:

id armeabi-v7a arm64-v8a x86 x86-64 note
1 yes yes yes yes -
2 yes yes yes yes -
3 yes yes yes yes -
4 yes yes yes yes -

Android Platform dynamic library(.so) support list:

id armeabi-v7a arm64-v8a x86 x86-64 note
1 yes yes yes yes -
2 yes yes yes yes -
3 yes no yes yes -
4 no yes no no -

Android Platform support lists:

Extended instructions

Use the entry script to build the target library.

ios.sh is the ios platform entry script.

android.sh is the android platform entry script.

Advanced use:

target version test result
default pass
higher generally pass
low maybe not pass

Contribution notes

Adding subscripts requires some experience in scripting and project building.

Adding subscripts can generally be a contributor to the project.

Adding subscript details:

  • Update parameters:
    • COMMON_LIBRARY_ID_LIST
    • COMMON_LIBRARY_NAME_LIST
    • COMMON_LIBRARY_VERSION_LIST
    • COMMON_LIBRARY_URL_LIST
  • Update method:
    • common_get_library_id_from_name
  • script:
    • Usage agreement:
      • A script method or function needs to use the keyword function.
      • Global variables need to use the keyword export and are combined with uppercase alphanumeric and underlined characters.
      • Script methods or local variables within functions use the keyword local.
      • Methods within the common.sh script need to use the prefix common_.
      • ios-*.sh script methods need to use the prefix ios_.
      • android-*.sh script methods need to use the prefix android_.
      • Methods in the util. Sh script require the prefix util_.
      • Methods within the subscript need to use the prefix xxx_.
      • Composite scripts require the use of composite prefixes.
    • Method implementation:
      • ${COMMON_PLATFORM_TYPE}_${COMMON_LIBRARY_NAME}_printf_variable: (optional)
      • ${COMMON_PLATFORM_TYPE}_${COMMON_LIBRARY_NAME}_pre_tool_check: (must)
      • ${COMMON_PLATFORM_TYPE}_${COMMON_LIBRARY_NAME}_pre_download_zip: (must)
      • ${COMMON_PLATFORM_TYPE}_${COMMON_LIBRARY_NAME}_build_unzip: (must)
      • ${COMMON_PLATFORM_TYPE}_${COMMON_LIBRARY_NAME}_build_config_make: (must)
      • ${COMMON_PLATFORM_TYPE}_${COMMON_LIBRARY_NAME}_archive: (must)
  • Contribution notes:
    • AsteriskZuo: Create the project and complete the main frame design.

2. Architecture design

Programming language

bash shell script

Build platform:

MaoOS

Linux: TODO:

Target platform:

iOS

Android

Core ideas:

  • Plug-in programming:
    • You can build the target library by writing a corresponding subscript and adding parameters.
  • Dynamic call:
    • Similar to C++ polymorphism.
  • High reusability:
    • All code blocks are encapsulated using methods (functions).
  • Dependent detection:
    • Build target library dependency detection:
      • manual build
      • auto build all dependency target library: TODO:
  • To reconstruct the configure: TODO:

Project structure:

  • Input:
    • Source directory:
      • GNU make project:
      • cmake project: No build script is required. The iOS platform has a better way, and the Android platform directly introduces cmakelist files.
    • Build tools:
      • iOS independent compiler tool chain
      • Android independent compiler tool chain.
      • More ...
  • Output:
    • Interim interim documents:
      • Temporary intermediate file.
      • Build the library product.
    • Build library products:
  • Script:
    • Entry script:
      • ios.sh: iOS platform entry script.
      • android.sh: Android platform entry script.
    • Tool script:
      • util.sh: Provide various basic functions.
      • log.sh: Provide various basic functions.
      • common.sh: Provide common functions for iOS and Android platforms.
      • ios-common.sh: Provide common functions for iOS platform.
      • android-common.sh: Provide common functions of Android platform.
    • Subscript(plug-in script):
      • ios-openssl.sh:
      • android-openssl.sh:
      • ios-curl.sh:
      • android-curl.sh:
      • More ...

3. Problems to be solved

Only current list item builds are supported.

Project-made versions can be built, but may not be built properly for lower versions.

Building the dependencies of the target project requires manual construction.

4. Reference

openssl_for_ios_and_android

5. Document

simple-build-ios-and-android-script