Changes between Version 3 and Version 4 of AndroidBuildApp


Ignore:
Timestamp:
Jun 25, 2013, 1:20:28 AM (11 years ago)
Author:
Joachim
Comment:

update to new naming and build scripts in repo

Legend:

Unmodified
Added
Removed
Modified
  • AndroidBuildApp

    v3 v4  
    11[[PageOutline]]
    2 = How To Build BOINC Apps for AndroidBOINC =
     2= How To Build BOINC Apps for BOINC on Android =
    33
    44This document describes how to build BOINC scientific apps
    5 to be executed by AndroidBOINC on Android-powered devices.
     5to be executed on Android-powered devices.
    66
    77
     
    1010== Naming convention ==
    1111
    12 '''AndroidBOINC''' - Android application that bundles a cross compiled BOINC
     12'''BOINC on Android''' - Android application that bundles a cross compiled BOINC
    1313Client together with a Android-specific BOINC Manager (GUI).
    1414
     
    2020
    2121 * Android NKD: http://developer.android.com/tools/sdk/ndk/index.html
    22  * AndroidBOINC build script: [https://github.com/novarow/AndroidBOINC/blob/master/native/build_android.sh]
     22 * BOINC on Android build script: [http://boinc.berkeley.edu/trac/browser/boinc-v2/android]
    2323
    2424
     
    3434
    3535
    36 == Compatibility with AndroidBOINC ==
     36== Compatibility with BOINC on Android ==
    3737
    38 Caution: Verification whether volunteering Android devices meets the requirements
    39 is only done upon AndroidBOINC app installation.
     38Caution: BOINC on Android runs on all ARM based Android devices. The minimum requirement is therefore ARM ABIv5. Higher ABIs or specific CPU capabilities might only be available on a subset of volunteer's devices.
    4039It is the project's responsibility to ensure,
    41 that distributed BOINC apps meet the requirements.
    42 If a higher minimum platform version is used for BOINC apps than for AndroidBOINC,
    43 they are likely to crash on some devices.
     40that distributed BOINC apps meet these requirements. The client reports CPU capabilities, i.e. VFP and NEON support, to the project server.
     41It is recommended to have a fallback version for ARM ABIv5, since not all devices might have higher ABIs available.
    4442
    45 There are two approaches to this:
    46  *  use the same toolchain and AndroidBOINC build script configuration for
    47    building the BOINC Client and BOINC apps.
    48  *  make use of "BOINC platform" configuration of the AndroidBOINC
    49    build script to distinct versions with the scheduler.
     43== BOINC platform name ==
    5044
     45BOINC on Android uses BOINC platform identifier: "arm-android-linux-gnu"
    5146
    5247= Setup NDK toolchain =
     
    5449==  Setup NDK toolchain ==
    5550
    56 Note: 0.3 Compatibility with AndroidBOINC
    57 
    5851To set up a custom cross compilation toolchain,
    5952see article at AndroidBuildClient
    6053
    6154
    62 = Invoke build script =
     55= Build script =
    6356
    64 It is recommended to use the same AndroidBOINC build script for compiling BOINC apps
    65 and the BOINC Client for AndroidBOINC.
     57Take a look at the build scripts in the BOINC software repository. They give you an idea of what steps are required and which cross compilation tools to use.
    6658
    67 It is possible to adapt the scripts routine,
    68 by un-setting the environment variables BUILDOPENSSL, BUILDCURL and BUILDBOINC.
     59There are also scripts available, which build required software components, i.e. curl and openSSL, or BOINC libs.
    6960
    7061