Transcript
Page 1: Android Native Apps Development

Desenvolvendo Apps Nativas com NDK

Eduardo Carrara de AraujoSoftware Analyst – Intel Software

Page 2: Android Native Apps Development

Agenda

• Entendendo o mundo Android* Nativo• Conhecendo suas ferramentas• Preparando-se para a batalha• Mãos à obra!• Quebrou! E agora?• Q&A

2

Page 3: Android Native Apps Development

INTEL CONFIDENTIAL

Entendendo o mundo Android* Nativo

Page 4: Android Native Apps Development

4

As Engrenagens do Robô

App

sA

pplic

ation

Fr

amew

ork

Home Contacts Phone Browser

Activity Manager Windows* Manager

Telephony Manager

Resource Manager

Content Providers View System

Location Manager Notification ManagerPackage Manager

Surface Manager

OpenGL* ES

SGL

Media Framework

FreeType

SSL

SQLite

WebKit

libc

Core Libraries

Dalvik Virtual Machine

Display Driver Camera Driver Flash Memory Driver Binder (IPC) Driver

Keypad Driver WiFi Driver Audio Drivers Power Management

Libraries

Linux* Kernel

Android* Runtime

Apps

Use

r Ex

peri

ence

Mid

dlew

are

Ope

ratin

g Sy

stem

Page 5: Android Native Apps Development

5

Nativo VS. Dalvik*

• O que é uma aplicação Android* nativa?

• O que a Intel já faz por você? Android Runtime

Core Libraries

Dalvik Virtual Machine

Page 6: Android Native Apps Development

6

Por quê utilizar código nativo?

• Performance• Jogos• Processamento Gráfico• Criptografia• Algoritmos de baixo nível• Acesso direto à CPU, GPU e outros recursos de HW• Reuso de código• E por que não utilizar?

• Performance• Complexidade

Page 7: Android Native Apps Development

INTEL CONFIDENTIAL

Conhecendo suas ferramentas

7

Page 8: Android Native Apps Development

Android* Native Development Kit (NDK)

•O que é?• Conjunto de ferramentas que permitem a

implementação de partes da aplicação Android utilizando código nativo em linguagens como C ou C++.

• A interação entre o código nativo e a app Android é feita utilizando Java Native Interface (JNI).

Page 9: Android Native Apps Development

9

Java Native Interface (JNI)

• O que é?• Interface padrão de programação para interoperabilidade entre

bibliotecas nativas de uma plataforma e a máquina virtual Java.

• Quando usar?• Acessar funcionalidades dependentes de plataforma não

providas pela API padrão do Java.• Re-uso de código.• Porções de código que precisam de tuning de performance.

Page 10: Android Native Apps Development

10

Fluxo de Desenvolvimento com NDK

C/C++Code

Makefile

ndk-build

Java* calls

GDB debug

Java Framework

Java ApplicationSDK APIs

JNI

Native Libs

Android* Applications

NDK APIs

Bionic C Library

APP_ABI := allor APP_ABI := x86

JNI

Page 11: Android Native Apps Development

12

Conheça os limites: A Bionic C

• Biblioteca C otimizada para a plataforma Android.• Mais leve que a GNU C.• Não segue o padrão POSIX.• Suporte limitado à pthreads.• Acesso às propriedades do Android

Page 12: Android Native Apps Development

INTEL CONFIDENTIAL

Preparando-se para a batalha

14

Page 14: Android Native Apps Development

16

Adicionando Suporte Nativo (Eclipse*)

Page 15: Android Native Apps Development

17

Sem o piloto automático

Standard Android* Project Structure

Native Sources - JNI Folder 1. Create JNI folder for native sources

3. Create Android.mk Makefile

4. Build Native libraries using NDK-BUILD script.

2. Reuse or create native c/c++ sources

NDK-BUILD will automatically create ABI libs folders.

Page 16: Android Native Apps Development

INTEL CONFIDENTIAL

Mãos à obra!

Page 17: Android Native Apps Development

19

Hello NDK!

• Agora que temos um projeto pronto para utilizar código nativo. Qual o próximo passo?• Como integrar o código Java com o C++?

Page 18: Android Native Apps Development

20

Integrando Funções Nativas com Java

• Declarar métodos nativos em Java:• public native String getHelloMessage();

• A aplicação Java deve carregar a biblioteca antes de utilizá-la:• System.loadLibrary("HelloNDK");

• Implementar em sua biblioteca nativa os métodos a serem utilizados pela aplicação• Os pontos de entrada da biblioteca podem ser criados de duas

formas: com a ferramenta Javah ou as registrando na função JNI_onLoad na biblioteca.

Page 19: Android Native Apps Development

21

Javah

• Gera os “header stubs” apropriados para JNI à partir das classes Java já compiladas.• Example: > javah –d jni –classpath bin/classes \com.example.hellojni.HelloJni

• Gera o arquivo: com_example_hellojni_HelloJni.h

• Com a definição: JNIEXPORT jstring JNICALL Java_com_example_hellojni_HelloJni_stringFromJNI(JNIEnv *, jobject);

Page 20: Android Native Apps Development

Javah

jstring Java_com_example_hellojni_HelloJni_stringFromJNI(JNIEnv* env,

jobject thiz ){ return (*env)->NewStringUTF(env, "Hello from JNI !");}

... {

...tv.setText( stringFromJNI() );...

}

public native String stringFromJNI();

static { System.loadLibrary("hello-jni"); }

Page 21: Android Native Apps Development

23

JNI_onLoad

• Registro das funções JNI no carregamento

da biblioteca.

• Utilizado nos módulos nativos do AOSP.

• Sujeito a menos erros durante refatoração.

• Melhor local para lidar com o caching de

referências à objetos Java.

Page 22: Android Native Apps Development

24

JNI_onLoad

• Declare a função C++ em sua lib:jstring stringFromJNI(JNIEnv* env, jobject thiz){ return env->NewStringUTF("Hello from JNI !");}

• Crie o mapeamento de funções expostas:static JNINativeMethod exposedMethods[] = {{"stringFromJNI","()Ljava/lang/String;",(void*)stringFromJNI},}

• Utilize a ferramenta javap para obter a assinatura dos métodos nativos:

javap -s -classpath bin\classes -p com.example.hellojni.HelloJni-> Signature: ()Ljava/lang/String;

Page 23: Android Native Apps Development

25

JNI_onLoad

extern "C" jint JNI_OnLoad(JavaVM* vm, void* reserved){ JNIEnv* env; if (vm->GetEnv(reinterpret_cast<void**>(&env), JNI_VERSION_1_6) != JNI_OK) return JNI_ERR;

jclass clazz = env->FindClass("com/intel/applab/nativesample/NativeSample"); if(clazz==NULL)

return JNI_ERR;

env->RegisterNatives(clazz, exposedMethods, sizeof(exposedMethods)/sizeof(JNINativeMethod)); env->DeleteLocalRef(clazz); return JNI_VERSION_1_6;}

Page 24: Android Native Apps Development

26

Estamos prontos? Não!

• Utilizar o arquivo Application.mk para descrever sua app:• Diretório: jni• Descrever os módulos necessários• Arquiteturas suportadas: ABI• Arquivo opcional mas importante para garantir que seus

módulos nativos sejam compilados para diversas plataformas.

APP_ABI := armeabi armeabi-v7a x86OuAPP_ABI := all

Page 25: Android Native Apps Development

27

Build it!

• Utilizando Eclipse*• Com a integração ADT e NDK no Eclipse* basta compilar a app

para gerar as bibliotecas e empacotar seu apk.

• Hardcore Mode• Utilizar o script ndk_build para gerar os módulos.• No diretório raíz de sua app execute:

• $NDK/ndk_build

Page 26: Android Native Apps Development

INTEL CONFIDENTIAL

Quebrou! E agora?

Page 27: Android Native Apps Development

29

LogCat

• Mecanismo básico de logs do Android. No NDK pode ser acessado pela API: <android/log.h>• int __android_log_print(int prio, const char *tag, const char *fmt, ...)

• Normalmente utilizado com a macro:• #define LOGI(...) ((void)__android_log_print(ANDROID_LOG_INFO, "APPTAG", __VA_ARGS__))

• Exemplo• LOGI("accelerometer: x=%f y=%f z=%f", x, y, z);

Page 28: Android Native Apps Development

INTEL CONFIDENTIAL

Q&A

31

Page 29: Android Native Apps Development

32

Legal DisclaimerINFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT.A "Mission Critical Application" is any application in which failure of the Intel Product could result, directly or indirectly, in personal injury or death. SHOULD YOU PURCHASE OR USE INTEL'S PRODUCTS FOR ANY SUCH MISSION CRITICAL APPLICATION, YOU SHALL INDEMNIFY AND HOLD INTEL AND ITS SUBSIDIARIES, SUBCONTRACTORS AND AFFILIATES, AND THE DIRECTORS, OFFICERS, AND EMPLOYEES OF EACH, HARMLESS AGAINST ALL CLAIMS COSTS, DAMAGES, AND EXPENSES AND REASONABLE ATTORNEYS' FEES ARISING OUT OF, DIRECTLY OR INDIRECTLY, ANY CLAIM OF PRODUCT LIABILITY, PERSONAL INJURY, OR DEATH ARISING IN ANY WAY OUT OF SUCH MISSION CRITICAL APPLICATION, WHETHER OR NOT INTEL OR ITS SUBCONTRACTOR WAS NEGLIGENT IN THE DESIGN, MANUFACTURE, OR WARNING OF THE INTEL PRODUCT OR ANY OF ITS PARTS.Intel may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined". Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The information here is subject to change without notice. Do not finalize a design with this information.The products described in this document may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request.Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order.Copies of documents which have an order number and are referenced in this document, or other Intel literature, may be obtained by calling 1-800-548-4725, or go to: http://www.intel.com/design/literature.htm

Silvermont and other code names featured are used internally within Intel to identify products that are in development and not yet publicly announced for release. Customers, licensees and other third parties are not authorized by Intel to use code names in advertising, promotion or marketing of any product or services and any such use of Intel's internal code names is at the sole risk of the user.

Intel, Atom, Look Inside and the Intel logo are trademarks of Intel Corporation in the United States and other countries.

*Other names and brands may be claimed as the property of others.Copyright ©2013 Intel Corporation.

Page 30: Android Native Apps Development

33

Legal Disclaimer

• Roadmap Notice: All products, computer systems, dates and figures specified are preliminary based on current expectations, and are subject to change without notice.

• Intel® Virtualization Technology (Intel® VT) requires a computer system with an enabled Intel® processor, BIOS, and virtual machine monitor (VMM).  Functionality, performance or other benefits will vary depending on hardware and software configurations.  Software applications may not be compatible with all operating systems.  Consult your PC manufacturer.  For more information, visit http://www.intel.com/go/virtualization.

• Software Source Code Disclaimer: Any software source code reprinted in this document is furnished under a software license and may only be used or copied in accordance with the terms of that license. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Page 31: Android Native Apps Development

34

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel.

Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804

Page 32: Android Native Apps Development

35

Risk FactorsThe above statements and any others in this document that refer to plans and expectations for the third quarter, the year and the future are forward-looking statements that involve a number of risks and uncertainties. Words such as “anticipates,” “expects,” “intends,” “plans,” “believes,” “seeks,” “estimates,” “may,” “will,” “should” and their variations identify forward-looking statements. Statements that refer to or are based on projections, uncertain events or assumptions also identify forward-looking statements. Many factors could affect Intel’s actual results, and variances from Intel’s current expectations regarding such factors could cause actual results to differ materially from those expressed in these forward-looking statements. Intel presently considers the following to be the important factors that could cause actual results to differ materially from the company’s expectations. Demand could be different from Intel's expectations due to factors including changes in business and economic conditions; customer acceptance of Intel’s and competitors’ products; supply constraints and other disruptions affecting customers; changes in customer order patterns including order cancellations; and changes in the level of inventory at customers. Uncertainty in global economic and financial conditions poses a risk that consumers and businesses may defer purchases in response to negative financial events, which could negatively affect product demand and other related matters. Intel operates in intensely competitive industries that are characterized by a high percentage of costs that are fixed or difficult to reduce in the short term and product demand that is highly variable and difficult to forecast. Revenue and the gross margin percentage are affected by the timing of Intel product introductions and the demand for and market acceptance of Intel's products; actions taken by Intel's competitors, including product offerings and introductions, marketing programs and pricing pressures and Intel’s response to such actions; and Intel’s ability to respond quickly to technological developments and to incorporate new features into its products. The gross margin percentage could vary significantly from expectations based on capacity utilization; variations in inventory valuation, including variations related to the timing of qualifying products for sale; changes in revenue levels; segment product mix; the timing and execution of the manufacturing ramp and associated costs; start-up costs; excess or obsolete inventory; changes in unit costs; defects or disruptions in the supply of materials or resources; product manufacturing quality/yields; and impairments of long-lived assets, including manufacturing, assembly/test and intangible assets. Intel's results could be affected by adverse economic, social, political and physical/infrastructure conditions in countries where Intel, its customers or its suppliers operate, including military conflict and other security risks, natural disasters, infrastructure disruptions, health concerns and fluctuations in currency exchange rates. Expenses, particularly certain marketing and compensation expenses, as well as restructuring and asset impairment charges, vary depending on the level of demand for Intel's products and the level of revenue and profits. Intel’s results could be affected by the timing of closing of acquisitions and divestitures. Intel's results could be affected by adverse effects associated with product defects and errata (deviations from published specifications), and by litigation or regulatory matters involving intellectual property, stockholder, consumer, antitrust, disclosure and other issues, such as the litigation and regulatory matters described in Intel's SEC reports. An unfavorable ruling could include monetary damages or an injunction prohibiting Intel from manufacturing or selling one or more products, precluding particular business practices, impacting Intel’s ability to design its products, or requiring other remedies such as compulsory licensing of intellectual property. A detailed discussion of these and other factors that could affect Intel’s results is included in Intel’s SEC filings, including the company’s most recent reports on Form 10-Q, Form 10-K and earnings release.

Page 33: Android Native Apps Development
Page 34: Android Native Apps Development

Backup

Page 35: Android Native Apps Development

Handling JVM and Java objects from native code

Page 36: Android Native Apps Development

Memory handling of Java objects

• Memory handling of Java objects is done by the JVM:• You only deal with references to these objects.• Each time you get a reference, you must not

forget to delete it after use so the JVM can free it later

• local references are automatically freed when the native call returns to Java

• Global references are only created by NewGlobalRef()

Page 37: Android Native Apps Development

Creating a Java stringC:jstring string =

(*env)->NewStringUTF(env, "new Java String");

C++:jstring string = env->NewStringUTF("new Java String");

Main difference with compiling JNI code in C and in C++ is the nature of env as you can see it here.Remember that otherwise, the API is the same.

Page 38: Android Native Apps Development

Getting a C/C++ string from Java string

const char *nativeString = (*env)->GetStringUTFChars(javaString, null);…(*env)->ReleaseStringUTFChars(env, javaString, nativeString);

//more secure and efficient:int tmpjstrlen = env->GetStringUTFLength(tmpjstr);char* fname = new char[tmpjstrlen + 1];env->GetStringUTFRegion(tmpjstr, 0, tmpjstrlen, fname);fname[tmpjstrlen] = 0;…delete fname;

Page 39: Android Native Apps Development

Handling Java exceptions

// call to java methods may throw Java exceptions jthrowable ex = (*env)->ExceptionOccurred(env);if (ex!=NULL) {

(*env)->ExceptionClear(env);// deal with exception

}

(*env)->DeleteLocalRef(env, ex);

Page 40: Android Native Apps Development

Calling Java methodsOn an object instance:jclass clazz = (*env)->GetObjectClass(env, obj);jmethodID mid = (*env)->GetMethodID(env, clazz, "methodName", "(…)…");if (mid != NULL)

(*env)->Call<Type>Method(env, obj, mid, parameters…);

Static call:jclass clazz = (*env)->FindClass(env, "java/lang/String");jmethodID mid = (*env)->GetStaticMethodID(env, clazz, "methodName", "(…)…");if (mid != NULL)

(*env)->CallStatic<Type>Method(env, clazz, mid, parameters…);

• (…)…: method signature• parameters: list of parameters expected by the Java method• <Type>: Java method return type

Page 41: Android Native Apps Development

Throwing Java exceptions

jclass clazz =(*env->FindClass(env, "java/lang/Exception");

if (clazz!=NULL) (*env)->ThrowNew(env, clazz, "Message");

The exception will be thrown only when the JNI call returns to Java, it will not break the current native code execution.

Page 42: Android Native Apps Development

INTEL CONFIDENTIAL

Usando GDB

45

Page 43: Android Native Apps Development

Debugging with GDB and Eclipse• Native support must be added to your project• Pass NDK_DEBUG=1 to the ndk-build command, from the

project properties:

NDK_DEBUG flag is supposed to be automatically set for a debug build, but this is not currently the case.

Page 44: Android Native Apps Development

Debugging with GDB and Eclipse*

• When NDK_DEBUG=1 is specified, a “gdbserver” file is added to your libraries

Page 45: Android Native Apps Development

Debugging with GDB and Eclipse*

• Debug your project as a native Android* application:

Page 46: Android Native Apps Development

Debugging with GDB and Eclipse• From Eclipse “Debug” perspective, you can manipulate

breakpoints and debug your project

• Your application will run before the debugger is attached, hence breakpoints you set near application launch will be ignored


Recommended