Android, perfectionnement

• Version Java.
• Version Kotlin.

Android, perfectionnement

• Qui je suis.
• Qui vous êtes/ce que vous attendez.
• Présentation du plan.

Qui je suis

• Tristan SALAÜN.
• Développeur d'applications mobiles Android.
• Formateur Android/Java et Kotlin (scolaires et professionels).
• Co-fondateur de Startup Marseille.
  
• Fondateur de Light4Events.

Qui êtes vous ?

• Prénom.
• Expérience (Java, Mobile, Android).
• Attentes.

Étapes de mise en place :

• Android Studio.
• ADB.
• Téléphone en mode développeur.
• Coloration de logcat.
• Mise en place des templates.
• Mise en place de scrcpy.

Android Studio

ADB

• Ouvrons une invite de commande (Windows + R, cmd).
• Saisissons : adb version.

Téléphone en mode développeur

• En ligne de commande tapons : adb devices
• Vérifions dans Android Studio que le device apparaît bien.

Coloration de logcat

• File / Settings
• Cherchons : "logcat"
• Editor / Color Scheme / Android Logcat
• Les couleurs que j'ai définies (à titre d'exemple) :
  

  Assert	C00000
  Debug	41BB2E
  Error	FF6B68
  Info	F5F550
  Verbose	BBBBBB
  Warning	F4AC40

Récupération des LivesTemplates

• Récupération des LivesTemplates depuis la clé USB/mail/adresse web.
• A copier dans :
  • Windows: C:\Users\"user_name"\AppData\Roaming\Google\AndroidStudio4.1\templates
  • Linux: ~/.AndroidStudio"version"/config/templates
  • macOS: ~/Library/Preferences/AndroidStudio"version"/templates
• Nous verrons leur utilisation au fur et à mesure de la formation.

scrcpy

• Téléchargeons la dernière version sur GitHub.
• Décompressons le fichier ZIP dans un répértoire (C:\tools par exemple) ce qui donnera dans notre cas : C:\tools\scrcpy-win64-v1.16.
• Lançons l'utilitaire avec scrcpy.

Rappels des principes de base Android

• Activités.
• Fragments.
• Service.
• Intents.
• Bundle.
• Broadcast Receiver.
• Content Providers.

Présentation

• Point d'entrée dans l'application.
• Plusieurs points d'entrée pour une seule application.
• Faible dépendance entre activités.
• Une interface graphique.
• Pourquoi pas en plein écran (live template : and_fullscreen_immersive, à l'extérieur d'une méthode).
• Ou encore en mote PIP (Picture In Picture) (live template : and_pip, à l'extérieur d'une méthode).

Déclaration

<manifest ... >
  <application ... >
      <activity android:name=".ExampleActivity" />
      ...
  </application ... >
  ...
</manifest >

Intent filters

• Création d'un bouton qui va partager du texte.
• Création d'une activité qui va afficher le texte reçu.
• Ajout d'un Intent Filter à cette seconde activité.
• Test du résultat.

Création du bouton

• On déclare le bouton dans le Layout.
• On ajoute un OnClickListener.
• On implémente le partage du texte.

// Create the text message with a string
Intent sendIntent = new Intent();
sendIntent.setAction(Intent.ACTION_SEND);
sendIntent.setType("text/plain");
sendIntent.putExtra(Intent.EXTRA_TEXT, "Un texte à partager");
// Start the activity
startActivity(sendIntent);

// Create the text message with a string
val sendIntent = Intent()
with(sendIntent){
    action = Intent.ACTION_SEND
    type = "text/plain"
    putExtra(Intent.EXTRA_TEXT, "Un texte à partager")
}
// Start the activity
startActivity(sendIntent)

Création d'une nouvelle activité.

• File / New / Activity / Empty Activity (ReceiveTextActivity).
• Ajout du filtre dans le manifest
• Récupération et affichage du texte reçu.

<activity android:name=".ReceiveTextActivity">
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="text/plain" />
    </intent-filter>
</activity>

Bundle extras = getIntent().getExtras();
String receivedText = (extras != null) ? extras.getString(Intent.EXTRA_TEXT) : "";
Log.d(TAG, "onCreate received text = " + receivedText);

val receivedText = intent.extras?.getString(Intent.EXTRA_TEXT) ?: ""
Log.d(TAG, "onCreate received text = $receivedText")

Vérification de l'intent.

sendIntent.setAction("aaa");

Comment y remédier ?

// Verify that the intent will resolve to an activity
if (sendIntent.resolveActivity(getPackageManager()) != null) {
    startActivity(sendIntent);
}

Chooser.

Comment faire si l'on veut proposer le choix à chaque fois ?

On va forcer le lancement du chooser, avec le code suivant :

// Always use string resources for UI text.
// This says something like "Share this photo with"
String title = getResources().getString(R.string.chooser_title);
// Create intent to show the chooser dialog
Intent chooser = Intent.createChooser(sendIntent, title);
// Verify the original intent will resolve to at least one activity
if (sendIntent.resolveActivity(getPackageManager()) != null) {
    startActivity(chooser);
}

Chooser.

Comment faire si l'on veut proposer le choix à chaque fois ?

On va forcer le lancement du chooser, avec le code suivant :

// Always use string resources for UI text.
// This says something like "Share this photo with"
val title = resources.getString(R.string.chooser_title)
// Create intent to show the chooser dialog
val chooser = Intent.createChooser(sendIntent, title)
// Verify the original intent will resolve to at least one activity
if (sendIntent.resolveActivity(packageManager) != null) {
    startActivity(chooser)
}

Ouverture depuis un lien.

<intent-filter>
    <action android:name="android.intent.action.VIEW"/>

    <category android:name="android.intent.category.DEFAULT"/>
    <category android:name="android.intent.category.BROWSABLE"/>

    <data android:scheme="http"/>
    <data android:host="test.link.com"/>
</intent-filter>

Cycle de vie

Cycle de vie

Fragments

Fragments

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
          android:orientation="horizontal"
          android:layout_width="match_parent"
          android:layout_height="match_parent">
<fragment android:name="com.example.news.ArticleListFragment"
          android:id="@+id/list"
          android:layout_weight="1"
          android:layout_width="0dp"
          android:layout_height="match_parent" />
<fragment android:name="com.example.news.ArticleReaderFragment"
          android:id="@+id/viewer"
          android:layout_weight="2"
          android:layout_width="0dp"
          android:layout_height="match_parent" />
</LinearLayout>

Fragments

FragmentManager fragmentManager = getSupportFragmentManager();
FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();

ExampleFragment fragment = new ExampleFragment();
fragmentTransaction.add(R.id.fragment_container, fragment);
fragmentTransaction.commit();

Présentation du développement natif avec NDK. JNI.

• C/C++.
• Performances.
• Réutilisation de code.

Création d'un projet.

• Installation du NDK.
• Création d'un projet C/C++.
• Test.

Installation du NDK.

Installation du NDK.

Création d'un projet.

Nommage du projet.

Sélection de la toolchain.

Gestion erreur CMAKE.

CMAKE Installé.

Ajout CMAKE dans le path.

Test.

Instant Run

Débug

Débug

Débug

Débug

Debug en WiFi

adb tcpip 5555

adb connect 192.168.1.99

Debug en WiFi automatique

@echo off
echo Activate tcp mode
adb -d tcpip 5555

REM Sleep for 1 seconds
echo Wait a bit
ping -n 2 127.0.0.1>nul

echo Find IP
FOR /F "tokens=2 skip=1" %%A IN ('adb -d shell ip -f inet addr show wlan0') DO (
	FOR /F "tokens=1 delims=/" %%B IN ("%%A") DO (
 	    echo "Connecting to %%B"
		adb connect %%B
	)
	goto :eof
)

:eof

Profile

Templates intégrés

Live Templates

Live Templates

Gestion des graphiques

Gestion des graphiques

Gestion des graphiques

Gestion des graphiques

Gestion des graphiques

Gestion des graphiques

Changement de la teinte

• Est compacte.
• Être affichée avec différentes tailles sans perte de qualité.
• Changer de couleur facilement.

<ImageView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:src="@drawable/ic_cloud"
        android:tint="@color/colorAccent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintBottom_toBottomOf="parent" />

Gestion des graphiques

Les Toasts

Notification

Apports du SDK 6.0. Les permissions à la demande.

• Plus de protection de la vie privée.
• Granularité des permissions.
• Permissions à l'exécution.

Type de permissions

• Normal permissions.
• Signature permissions.
• Dangerous permissions.
• Special permissions (SYSTEM_ALERT_WINDOW et WRITE_SETTINGS).

Exemple d'utilisation

• Ajout dans le manifest.
• Vérification de l'accord.
• Gestion du retour.
• Mise en place rapide.
• Mise en place encore plus rapide.
• Solution alternative.

Ajout dans le manifest.

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.example.phonecall">

    <uses-permission android:name="android.permission.CALL_PHONE"/>

    <application ...>
        ...
    </application>
</manifest>

vérification de la permission.

if (ContextCompat.checkSelfPermission(thisActivity, Manifest.permission.CALL_PHONE)
        != PackageManager.PERMISSION_GRANTED) {
    // Permission is not granted
}

Demande de la permission.

// Here, thisActivity is the current activity
if (ContextCompat.checkSelfPermission(thisActivity,
        Manifest.permission.CALL_PHONE)
        != PackageManager.PERMISSION_GRANTED) {

    // Permission is not granted
    // Should we show an explanation?
    if (ActivityCompat.shouldShowRequestPermissionRationale(thisActivity,
            Manifest.permission.CALL_PHONE)) {
        // Show an explanation to the user *asynchronously* -- don't block
        // this thread waiting for the user's response! After the user
        // sees the explanation, try again to request the permission.
    } else {
        // No explanation needed; request the permission
        ActivityCompat.requestPermissions(thisActivity,
                new String[]{Manifest.permission.CALL_PHONE},
                MY_PERMISSIONS_REQUEST_CALL_PHONE);

        // MY_PERMISSIONS_REQUEST_CALL_PHONE is an
        // app-defined int constant. The callback method gets the
        // result of the request.
    }
} else {
    // Permission has already been granted
}

Gestion de la réponse

@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
    switch (requestCode) {
        case MY_PERMISSIONS_REQUEST_CALL_PHONE: {
            // If request is cancelled, the result arrays are empty.
            if (grantResults.length > 0
                && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                // permission was granted, yay! Do the job you need to do.
            } else {
                // permission denied, boo! Disable the functionality that depends on this permission.
            }
            return;
        }
        // other 'case' lines to check for other
        // permissions this app might request.
    }
}

Mise en place rapide.

• En dehors d'une méthode, utiliser le live template : and_permission_single.
• Choisir CALL_PHONE.
• Suivre les instructions dans les commentaires.
• Implémenter le code dans actionToBeCalled().
• Ajouter @SuppressLint("MissingPermission") sur cette méthode pour supprimer le warning.
• Appeler la méthode callAction().

Mise en place encore plus rapide.

• https://android-arsenal.com/tag/235?sort=rating

Solution alternative.

String url = "tel:"+"0612345678";
Intent callIntent = new Intent(Intent.ACTION_DIAL, Uri.parse(url));
startActivity(callIntent);

Autres exemples

• Accès à Internet (intent, et intent filter pour le retour).
• Accès aux contact (application de SMS, ...) : mode dégradé.
• Enregistrement dans la mémoire privée au lieu de la mémoire externe.

Outils avancés de développement

• Paramétrer le build avec Gradle.
• Améliorer son code source avec Lint.
• Mettre au point et profiler/monitorer une application.
• Optimisation de l'APK avec ProGuard.

Paramètres de base

android {
    compileSdkVersion 29
    buildToolsVersion "29.0.2"
    defaultConfig {
        applicationId "com.example.services"
        minSdkVersion 15
        targetSdkVersion 29
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'androidx.appcompat:appcompat:1.1.0'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'androidx.test:runner:1.2.0'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
}

Types de build

Flavors

buildTypes {
    // ...
}
flavorDimensions "version"
productFlavors {
    demo {
        dimension "version"
    }
    full {
        dimension "version"
    }
}

Dépendances

Mise en variable des versions

ext {
    appcompatVersion = '1.1.0'
    constraintLayoutVersion = '1.1.3'
    junitVersion = '4.12'
    runnerVersion = '1.2.0'
    espressoVersion = '3.2.0'
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation "androidx.appcompat:appcompat:$appcompatVersion"
    implementation "androidx.constraintlayout:constraintlayout:$constraintLayoutVersion"
    testImplementation "junit:junit:$junitVersion"
    androidTestImplementation "androidx.test:runner:$runnerVersion"
    androidTestImplementation "androidx.test.espresso:espresso-core:$espressoVersion"
}

Améliorer son code source avec Lint

Analyse du code

Configurer Lint

• Utiliser l'ampoule jaune ou rouge.
• Créer un fichier lint.xml à la racine du projet.
• Utiliser l'annotation @SuppressLint.

Exemple de fichier lint.xml

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <!-- Disable the given check in this project -->
    <issue id="IconMissingDensityFolder" severity="ignore" />

    <!-- Ignore the ObsoleteLayoutParam issue in the specified files -->
    <issue id="ObsoleteLayoutParam">
        <ignore path="res/layout/activation.xml" />
        <ignore path="res/layout-xlarge/activation.xml" />
    </issue>

    <!-- Ignore the UselessLeaf issue in the specified file -->
    <issue id="UselessLeaf">
        <ignore path="res/layout/main.xml" />
    </issue>

    <!-- Change the severity of hardcoded strings to "error" -->
    <issue id="HardcodedText" severity="error" />
</lint>

Mettre au point et profiler/monitorer une application.

• CPU Profiler.
• Memory Profiler.
• Network Profiler.
• Energy Profiler.

Optimisation de l'APK avec ProGuard.

• Il faut penser à ajouter le repository maven { url "https://jitpack.io" } (Page du projet).
• L'erreur Can’t find referenced class org.sl4j ne semble plus être d'actualité.

Internationalisation

• Ajouter une langue.
• Ajouter des clés.
• Tester dans l'éditeur.
• Tester sur l'émulateur.
• Tester sur le téléphone.

Internationalisation

Internationalisation

Internationalisation

Internationalisation

Internationalisation

Construction d'IHM avancées suivant les préconisations Material Design.

• Couleurs.
• Buttons.
• Champs texte.
• TextView ajustable.
• Résumé des bonnes pratiques.

Boutons

Champs texte

Fonts externes

SeekBar

TextView automatique

Bouton flottant

Utilisation des styles

• colors.xml
• dimens.xml
• styles.xml

Déclaration des couleurs

Déclaration des tailles

• dp
• sp
• px, in, ...

Déclaration des styles

<style name="DialogTitle" parent="AppTheme">
    <item name="android:padding">@dimen/dialog_title_text_padding</item>
    <item name="android:textSize">@dimen/dialog_title_text_size</item>
    <item name="android:textStyle">bold</item>
</style>

Aller plus loin

• MDC-101 Android: Material Components (MDC) Basics (Java)
• MDC-102 Android: Material Structure and Layout (Java)
• MDC-103 Android: Material theming with Color, Motion and Type (Java)
• MDC-104 Android: Material Advanced Components (Java)

Mécanismes des widgets

CharSequence widgetText = context.getString(R.string.appwidget_text);

Date current = new Date();
SimpleDateFormat dateFormat = new SimpleDateFormat("dd MMM yyy");
String widgetText = dateFormat.format(current);

Présentation OpenGL/ES.

Ajout d'animations

TextView tvText;

tvText = findViewById(R.id.text);

findViewById(R.id.button).setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        tvText.setVisibility(tvText.getVisibility() == View.VISIBLE ? View.GONE : View.VISIBLE );
    }
});

android:animateLayoutChanges="true"

Ajout d'un fond en dégradé

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <gradient
            android:angle="90"
            android:endColor="#FFF"
            android:startColor="#CCC" />
</shape>

Transition entre les activités

Haut niveau d'animation

tools

tools:visibility="gone"

• Google Maps
• Géolocalisation
• LeaderBoard

Utiliser les Google Play Services.

@Override
public void onMapReady(GoogleMap googleMap) {
    mMap = googleMap;

    // Add a marker in Startup Marseille and move the camera
    LatLng startupMarseille = new LatLng(43.291590, 5.378210);
    mMap.addMarker(new MarkerOptions().position(startupMarseille).title("Marker at Startup Marseille."));
    mMap.moveCamera(CameraUpdateFactory.zoomTo(19));
    mMap.moveCamera(CameraUpdateFactory.newLatLng(startupMarseille));

}

Affichage position courante

implementation 'com.google.android.gms:play-services-location:17.0.0'

private Marker currentPosition;

FusedLocationProviderClient client = LocationServices.getFusedLocationProviderClient(this);

// Get the last known location
client.getLastLocation().addOnCompleteListener(this, new OnCompleteListener<Location>() {
    @Override
    public void onComplete(@NonNull Task<Location> task) {
        // TODO
    }
});

Affichage du marker

LatLng currentLocation = new LatLng(task.getResult().getLatitude(), task.getResult().getLongitude());
currentPosition = mMap.addMarker(new MarkerOptions().position(currentLocation).title("Current position").icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_GREEN)));

Gestion des autorisations

com.google.android.gms.tasks.RuntimeExecutionException: java.lang.SecurityException: Client must have ACCESS_COARSE_LOCATION or ACCESS_FINE_LOCATION permission to perform any location operations.

• Activer directement dans les paramètres de l'application (pour tester).
• Demander la permission dynamiquement.

Erreur de position sur l'émulateur

LeaderBoard

Récapitulatif des services

Intégrer des bibliothèques tierces à un projet Android.

• Déclenchez le sélecteur sur le click d'un bouton.
• Nous modifierons la couleur de fond de l'application.
• La couleur initiale du sélecteur doit être la couleur du fond de l'application.

int color = Color.RED;
Drawable background = rootView.getBackground();
if (background instanceof ColorDrawable)
    color = ((ColorDrawable) background).getColor();

Intégration d'un scanner de QRCode

Intégration d'une push notification

Simplifier l'accès à des ressources REST avec Retrofit.

Maîtriser le chargement des images avec Picasso.

• Ajoutons une ImageView à notre projet.
• Ajoutons la librairie dans le gradle.
• Ajoutons la permission INTERNET.
• Utilisons la librairie comme indiqué dans la documentation.

ImageView imageView = findViewById(R.id.image);
Picasso.get().setLoggingEnabled(true);
Picasso.get().setIndicatorsEnabled(true);
Picasso.get().load("https://upload.wikimedia.org/wikipedia/commons/d/da/Internet2.jpg").into(imageView);

Glide

Glide.with(this).load("https://upload.wikimedia.org/wikipedia/commons/d/da/Internet2.jpg").into(imageView);

L'injection de dépendances (Dagger).

Définition

• Création d'une custom view à partir du template.
• Personnalisation du modèle.

Création du modèle

Utilisation du modèle

• Utilisation de la vue custom.
• Détail des attributs.
• Détail du code.

La vue à obtenir

Exercice

• Paint.
• translate.
• rotate.
• setColor.
• Path.
• drawArc.

Solution

private int mAngle = 0;
	

public void setmAngle(int mAngle) {
        this.mAngle = mAngle;
        invalidate();
}
	

Solution

protected void onDraw(Canvas canvas) {
    super.onDraw(canvas);

    int cx = getWidth() / 2;
    int cy = getHeight() / 2;

    Paint paint = new Paint();

    // Définir la flèche
    Path northPath = new Path();
    northPath.moveTo(0, -cy);
    northPath.lineTo(-10, 0);
    northPath.lineTo(10, 0);
    northPath.close();

    // Dessiner le cercle de fond
    // Définir le rectangle contenant le cercle que l'on va dessiner
    RectF pitchOval = new RectF(0, 0, getWidth(), getHeight());

    paint.setColor(Color.BLACK);
    canvas.drawArc(pitchOval, 0, 360, false, paint);

    canvas.translate(cx, cy);
    canvas.rotate(mAngle);
    paint.setColor(Color.RED);
    canvas.drawPath(northPath, paint);
}

Solution complète

public class MyView extends View {
    private int mAngle = 0;

    public MyView(Context context) {
        super(context);
    }

    public MyView(Context context, AttributeSet attrs) {
        super(context, attrs);
    }

    public MyView(Context context, AttributeSet attrs, int defStyle) {
        super(context, attrs, defStyle);
    }

    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);

        int cx = getWidth() / 2;
        int cy = getHeight() / 2;

        Paint paint = new Paint();

        // Définir la flèche
        Path northPath = new Path();
        northPath.moveTo(0, -cy);
        northPath.lineTo(-10, 0);
        northPath.lineTo(10, 0);
        northPath.close();

        // Dessiner le cercle de fond
        // Définir le rectangle contenant le cercle que l'on va dessiner
        RectF pitchOval = new RectF(0, 0, getWidth(), getHeight());

        paint.setColor(Color.BLACK);
        canvas.drawArc(pitchOval, 0, 360, false, paint);

        canvas.translate(cx, cy);
        canvas.rotate(mAngle);
        paint.setColor(Color.RED);
        canvas.drawPath(northPath, paint);
    }

    public void setmAngle(int mAngle) {
        this.mAngle = mAngle;
        invalidate();
    }
}

Mise en œuvre de capteurs.

• Nous allons lister les capteurs.
• Récupérer le capteur de proximité.
• S'enregistrer sur les changements.
• Réagir aux changements.

Exercice

Exemple complet de jeux

Paramétrage dans le simulateur des capteurs.

Paramétrage dans le simulateur des capteurs.

Paramétrage dans le simulateur des capteurs.

Définition

Utilisation d'un content provider

Uri media = MediaStore.Audio.Media.EXTERNAL_CONTENT_URI;
String[] projection = { MediaStore.Audio.Media._ID,           // 0
        MediaStore.Audio.Media.ARTIST,        // 1
        MediaStore.Audio.Media.TITLE,         // 2
        MediaStore.Audio.Media.ALBUM_ID,      // 3
        MediaStore.Audio.Media.ALBUM,         // 4
        MediaStore.Audio.Media.DATA,          // 5
        MediaStore.Audio.Media.DISPLAY_NAME,  // 6
        MediaStore.Audio.Media.DURATION };    // 7

String selection = MediaStore.Audio.Media.IS_MUSIC + " != 0";

Cursor cursor = getContentResolver().query(media,projection,selection,null,null);
while(cursor.moveToNext()){
    if(BuildConfig.DEBUG){
        Log.d(TAG, "onCreate " +
                        cursor.getString(0) + " " +
                cursor.getString(1) + " " +
                cursor.getString(2) + " " +
                cursor.getString(3) + " " +
                cursor.getString(4) + " " +
                cursor.getString(5) + " " +
                cursor.getString(6) + " " +
                cursor.getString(7) + " ");
    }
}

Un autre content provider

• Créer un AVD en API 22.
• Ajouter des entrées au dictionnaire.
• Utiliser le projet ContentProviderClient.
• Demander la permission.
• Interagir avec le content provider.

Créer un AVD en API 22

Ajouter des entrées au dictionnaire

Utiliser le projet ContentProviderClient

Demander la permission

<uses-permission android:name="android.permission.READ_USER_DICTIONARY"/>

Interagir avec le content provider

// A "projection" defines the columns that will be returned for each row
String[] projection = {
        UserDictionary.Words._ID,    // Contract class constant for the _ID column name
        UserDictionary.Words.WORD,   // Contract class constant for the word column name
        UserDictionary.Words.LOCALE  // Contract class constant for the locale column name
};

// Defines a string to contain the selection clause
String selectionClause = null;

// Initializes an array to contain selection arguments
String[] selectionArgs = null;

// Defines a string to order the result
String sortOrder = null;

// Does a query against the table and returns a Cursor object
Cursor mCursor = getContentResolver().query(
        UserDictionary.Words.CONTENT_URI,  // The content URI of the words table
        projection,                       // The columns to return for each row
        selectionClause,                  // Either null, or the word the user entered
        selectionArgs,                    // Either empty, or the string the user entered
        sortOrder);                       // The sort order for the returned rows

// Some providers return null if an error occurs, others throw an exception
if (null == mCursor) {
    /*
     * Insert code here to handle the error. Be sure not to use the cursor! You may want to
     * call android.util.Log.e() to log this error.
     *
     */
    if (BuildConfig.DEBUG) {
        Log.d(TAG, "onCreate CURSOR NULL");
    }
    // If the Cursor is empty, the provider found no matches
} else if (mCursor.getCount() < 1) {

    /*
     * Insert code here to notify the user that the search was unsuccessful. This isn't necessarily
     * an error. You may want to offer the user the option to insert a new row, or re-type the
     * search term.
     */
    if (BuildConfig.DEBUG) {
        Log.d(TAG, "onCreate CURSOR EMPTY");
    }

} else {
    // Insert code here to do something with the results
    try {
        while (mCursor.moveToNext()) {
            if (BuildConfig.DEBUG) {
                Log.d(TAG, "onCreate " +
                        mCursor.getLong(0) + " " +
                        mCursor.getString(1) + " " +
                        mCursor.getString(2) + " "
                );
            }
        }
    } finally {
        mCursor.close();
    }
}

Écrire dans le Content Provider

// Defines a new Uri object that receives the result of the insertion
Uri newUri;

// Defines an object to contain the new values to insert
ContentValues newValues = new ContentValues();

/*
* Sets the values of each column and inserts the word. The arguments to the "put"
* method are "column name" and "value"
*/
newValues.put(UserDictionary.Words.APP_ID, "example.user");
newValues.put(UserDictionary.Words.LOCALE, "en_US");
newValues.put(UserDictionary.Words.WORD, "insert");
newValues.put(UserDictionary.Words.FREQUENCY, "100");

newUri = getContentResolver().insert(
UserDictionary.Words.CONTENT_URI,   // the user dictionary content URI
newValues                          // the values to insert
);
if (BuildConfig.DEBUG) {
    Log.d(TAG, "onCreate " + newUri);
}

Mise à jour

// Defines an object to contain the updated values
ContentValues updateValues = new ContentValues();

// Defines selection criteria for the rows you want to update
String selectionClause = UserDictionary.Words.LOCALE +  " LIKE ?";
String[] selectionArgs = {"en_%"};

// Defines a variable to contain the number of updated rows
int rowsUpdated = 0;

/*
* Sets the updated value and updates the selected words.
*/
updateValues.putNull(UserDictionary.Words.LOCALE);

rowsUpdated = getContentResolver().update(
    UserDictionary.Words.CONTENT_URI,   // the user dictionary content URI
    updateValues,                      // the columns to update
    selectionClause,                   // the column to select on
    selectionArgs                      // the value to compare to
);

Effacer des données

// Defines selection criteria for the rows you want to delete
String selectionClause = UserDictionary.Words.WORD + " LIKE ?";
String[] selectionArgs = {"%insert%"};

// Defines a variable to contain the number of rows deleted
int rowsDeleted = 0;

// Deletes the words that match the selection criteria
rowsDeleted = getContentResolver().delete(
    UserDictionary.Words.CONTENT_URI,   // the user dictionary content URI
    selectionClause,                   // the column to select on
    selectionArgs                      // the value to compare to
);

Autres contents providers

• La liste des appels.
• La liste des SMS.
• Le répertoire des contacts.
• Les dictionnaires de l'utilisateur.
• La liste des favoris.
• ...

Les étapes

• Créer un projet ContentProvider.
• Implémenter rapidement la méthode query.
• Tester dans le projet ContentProviderClient la bonne réaction.
• Implémenter une base de donnée pour le Content Provider.

Implémentation rapide

@Override
public Cursor query(Uri uri, String[] projection, String selection,
                    String[] selectionArgs, String sortOrder) {

    MatrixCursor cursor = new MatrixCursor(new String[]{"name", "firstname"});
    cursor.newRow()
            .add("name", "SALAUN")
            .add("firstname", "Tristan");

    cursor.newRow()
            .add("name", "SNOW")
            .add("firstname", "John");
    return cursor;
    }

Test dans ContentProviderClient

Cursor cursor = getContentResolver().query(Uri.parse("content://com.exemple.contentprovider.provider"), null, null, null, null);
if(cursor.moveToFirst()) {
    StringBuilder strBuild=new StringBuilder();
    while (!cursor.isAfterLast()) {
        strBuild.append("\n"+cursor.getString(0)+ "-"+ cursor.getString(1));
        cursor.moveToNext();
    }
    if(BuildConfig.DEBUG){
        Log.d(TAG, "onCreate " + strBuild);
    }
}

Base de donnée avec Room

public class UserEntity {
    public String name;
    public String firstname;
}

Classe de contrat

import android.net.Uri;
import android.provider.BaseColumns;

public final class UserContract {
    // The Authority
    public static final String AUTHORITY = "com.exemple.contentprovider.provider";

    // The path to the data… and explain
    public static final String PATH_TO_DATA = "users"; //Vous pouvez déclarer plusieurs paths (les paths utilisent les /)


    public interface MyDatas extends BaseColumns {

        // The URI and explain, with example if you want
        public static final Uri CONTENT_URI = Uri.parse("content://" + UserContract.AUTHORITY + "/" + UserContract.PATH_TO_DATA);

        // My Column ID and the associated explanation for end-users
        public static final String KEY_COL_ID = _ID; // Mandatory

        // My Column Name and the associated explanation for end-users
        public static final String KEY_COL_NAME = "name";

        // My Column First Name and the associated explanation for end-users
        public static final String KEY_COL_FIRSTNAME = "firstName";

        // The index of the column ID
        public static final int ID_COLUMN = 1;
        // The index of the column NAME
        public static final int NAME_COLUMN = 2;
        // The index of the column FIRST NAME
        public static final int FIRSTNAME_COLUMN = 3;
    }
}

Intégration au content provider

public boolean onCreate() {
    Context context = getContext();
    userDao = AppDatabase.getDatabase(context).userDao();
    if (userDao != null) {
        return true;
    }
    return false;
}

Query

public Cursor query(Uri uri, String[] projection, String selection,
                    String[] selectionArgs, String sortOrder) {
    return userDao.getCursorAll();
}

Insert

 public Uri insert(Uri uri, ContentValues values) {
    UserEntity currentUserEntity = new UserEntity();
    if (values.containsKey(UserContract.MyDatas.KEY_COL_FIRSTNAME)) {
        currentUserEntity.firstname = values.getAsString(UserContract.MyDatas.KEY_COL_FIRSTNAME);
    }
    if (values.containsKey(UserContract.MyDatas.KEY_COL_NAME)) {
        currentUserEntity.name = values.getAsString(UserContract.MyDatas.KEY_COL_NAME);
    }
    long rowID = userDao.insert(currentUserEntity);
    if (rowID > 0) {
        Uri _uri = ContentUris.withAppendedId(UserContract.MyDatas.CONTENT_URI, rowID);
        getContext().getContentResolver().notifyChange(_uri, null);
        return _uri;
    }
    throw new SQLiteException("Failed to add a record into " + uri);
}

Cycle de vie des services.

Intent service.

Intent service.

Service bindé.

Le choix

Lier services et activités.

Utiliser des threads depuis un service.

for (int i = 0; i < 10; i++) {
    if (BuildConfig.DEBUG) {
        Log.d(TAG, "run background " + i);
    }
    try {
        Thread.sleep(1000);
    } catch (InterruptedException e) {
        e.printStackTrace();
    }
}

Plaçons maintenant le code dans notre service, que remarquons nous ?

Countdown simple

Définir des alarmes.

Travaux pratiques

• Initialiser la valeur.
• Lancer.
• Arrêter.
• Remettre à zéro.

Countdown évolué

Présentation des outils

• Test monkey.
• monkeyrunner.
• Test unitaire.
• Test d'intégration.
• Test fonctionnels de bout en bout.

Tests monkey

adb shell monkey -p your.package.name -v 500

monkeyrunner

• La référence ici.
• Astuces pour lancer monkeyrunner ici.

# -*- coding: utf-8 -*-

# https://developer.android.com/studio/test/monkeyrunner
# https://medium.com/@soonsantos/guide-to-run-monkeyrunner-e9363f36bca4

# Imports the monkeyrunner modules used by this program
from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice

# Connects to the current device, returning a MonkeyDevice object
device = MonkeyRunner.waitForConnection()

MonkeyRunner.alert(u"\n\nMonkeyRunnerScript\nMerci de vérifier que :\n\
        \t - Le téléphone est bien installé.\n\
        \n\n\n\n\n\
        Appuyez sur 'Continuer' POUR REPENDRE L'EXECUTION...","MonkeyRunner","Continuer");

print("Start")

# Presses the Home button
device.press('KEYCODE_HOME',MonkeyDevice.DOWN_AND_UP)

# sets a variable with the package's internal name
package = 'fr.salaun.tristan.todelete'

# sets a variable with the name of an Activity in the package
activity = 'fr.salaun.tristan.todelete.MainActivity'


apk_path = device.shell('pm path ' + package)
if apk_path.startswith('package:'):
    print "XXXYY already installed."
else:
    print "XXXYY app is not installed, installing APKs..."
    device.installPackage('D:/path to apk/yourapp.apk')

# sets the name of the component to start
runComponent = package + '/' + activity

# Runs the component
device.startActivity(component=runComponent)

# Wait a bit
MonkeyRunner.sleep(1)

# Takes a screenshot
print("Take screenshoot of screen")
result = device.takeSnapshot()

# Writes the screenshot to a file
result.writeToFile('screenshoot.png','png')


# ==================================================
# Go out of the application
device.press("KEYCODE_BACK", MonkeyDevice.DOWN_AND_UP)

Tests unitaires

Fonctions spéciales

• setup appelée avant chaque test
• tearDown appelée après chaque test

Assertions

• assertEquals(a,b)
• assertTrue(a) et assertFalse(a)
• assertSame(a,b) et assertNotSame(a,b)
• assertNull(a) et assertNotNull(a)
• fail(message)

Bonnes pratiques

• Écrire les test en même temps que le code.
• Tester uniquement ce qui peut vraiment provoquer des erreurs.
• Exécuter ses tests aussi souvent que possible, idéalement après chaque changement de code.
• Écrire un test pour tout bogue signalé (même s’il est corrigé).
• Ne pas tester plusieurs méthodes dans un même test : JUnit s’arrête à la première erreur.
• Attention, les méthodes privées ne peuvent pas être testées !

Simulation d'interactions utilisateur avec Espresso.

AndroidJUnit4 déprécié

androidTestImplementation 'androidx.test.ext:junit:1.1.1'

Test Content provider

uiautomatorviewer

Test Suite

Tests enregistrés

Utilisation de Cloud Test Lab.

Présentation

GUI

Contact picker

• L'implémentation du click pour sélectionner le contact.
• La récupération du contact lors du retour de la sélection.

Send SMS

• Récupération des références vers les EditText.
• Implémentation du click pour envoyer le SMS.
• Ajoutons la permission pour envoyer les SMS.
• Implémentation des classes de BroadcastReceiver.

Récupération des EditText

private EditText editTextNumber, editTextText;

editTextNumber = findViewById(R.id.activity_main_editText_number);
editTextText = findViewById(R.id.activity_main_editText_message);

Implémentation du code

sendSMS(getApplicationContext(), editTextNumber.getText().toString(), editTextText.getText().toString());

Permissions

Correction des erreurs

java.lang.SecurityException: Sending SMS message: uid XXXXX does not have android.permission.SEND_SMS.

• Soit oublié d'ajouter la permission dans le Manifest.xml.
• Soit oublié de demander la permission dynamiquement (Android 6.0+).

Allons plus loin

• Passons au Material design sur les EditText et les Buttons.
• Effectuons des tests sur les valeurs des champs.
• Mémorisons les dernières valeurs utilisées.
• Mettons en place un EventBus pour communiquer des BroadcastReceivers vers la MainActivity.

Raccourcis claviers utiles

Le mode démo

LivesTemplates

• and_tts : pour activer une synthèse vocale.
• and_intent_voice_recognition : pour activer une reconnaissance vocale.

TODO / FIXME

Universal ADB Drivers

Les gestures

• Projet gesture.

Le swipe

• OnSwipe.

Références utiles

• Liste de nombreuses librairies.
• JetPack.
• Liste de cours en Kotlin intéressants.
• GitLab.

Jetpack Compose

La passerelle Web et JS

• Tutoriel ici.

Contact Picker

Scripts batch/bash

echo Waiting for device on USB
adb wait-for-usb-device
echo Device found

echo Clear APP Tristan
adb shell pm clear fr.salaun.tristan.android.myapplication

echo Waiting for device on USB
adb wait-for-usb-device
echo Device found

echo "Delete APP Tristan"
adb uninstall fr.salaun.tristan.android.myapplication

Scripts batch/bash

#!/bin/bash

# example : ./install_all_apk.sh /c/apk/

echo Waiting for device on USB
adb wait-for-usb-device
echo Device found

echo "The path to use : $1"

for filename in $1/*.apk; do
   echo "installing $filename"
   adb install -r -d -g $filename
done

Scripts batch/bash

@echo off

SETLOCAL ENABLEDELAYEDEXPANSION
:: INSTALL ON ALL ATTACHED DEVICES ::
FOR /F "tokens=1,2 skip=1" %%A IN ('adb devices') DO (
	start "Sub" install_apk_all_devices_installer.bat %%A
)
ENDLOCAL

:EOF

Scripts batch/bash

@echo off
SET ARGUMENTS=%~1

if "%ARGUMENTS%" == "" (
    GOTO EOF
)

adb -s %ARGUMENTS% uninstall fr.salaun.tristan.android.myapplication

echo Waking up the device %ARGUMENTS%.
adb -s %ARGUMENTS% shell input keyevent KEYCODE_WAKEUP

REM Sleep for 2 seconds
echo Wait a bit
ping -n 5 127.0.0.1>nul

echo Unlock the screen
adb -s %ARGUMENTS% shell input keyevent 82

echo Install the application.
adb -s %ARGUMENTS% install -r -t D:\apk\debug\fr.salaun.tristan.android.myapplication-debug.apk

if errorlevel 1 goto performdeletebefore
echo Install Success!
goto launch
:performdeletebefore
echo Something bad happened during install.
echo Try to uninstall first.
adb -s %ARGUMENTS% uninstall fr.salaun.tristan.android.myapplication
adb -s %ARGUMENTS% install -r -t D:\apk\debug\fr.salaun.tristan.android.myapplication-debug.apk

if errorlevel 1 goto ERROR

:launch
echo Launch the application.
adb -s %ARGUMENTS% shell am start -n fr.salaun.tristan.android.myapplication/fr.salaun.tristan.android.myapplication.MainActivity

:EOF
exit

:ERROR
echo "Exit with error"

Utilisation du JSON avec GSON.

implementation 'com.google.code.gson:gson:2.8.6'

data class Book(var id: String, var name: String, var author: String, var genre: String, var numpages: Int, var releaseDate: String, var cover: String)

data class BookList (val bookList: List<Book>)

var list = arrayListOf(
Book(
    id = "01fsEF", name = "1984",
    author = "George Orwell",
    genre = "Fiction dystopique",
    numpages = 376,
    releaseDate = "1949",
    cover = "1984.png"
),
Book(
    id = "3H1J0n",
    name = "Le Meilleur des mondes",
    author = "Aldous Huxley",
    genre = "Science-fiction",
    numpages = 285,
    releaseDate = "1932",
    cover = "meilleur-des-mondes.jpg"
),
Book(
    id = "MbtsI7",
    name = "Malevil",
    author = "Robert Merle",
    genre = "Littératures de l'imaginaire",
    numpages = 541,
    releaseDate = "1972",
    cover = "malevil.jpg"
)
)

var bookList = BookList (list)

Utilisation du JSON avec GSON (suite).

fun jsonToPrettyFormat(jsonString: String?): String? {
    val json = JsonParser.parseString(jsonString).asJsonObject
    val gson = GsonBuilder()
        .serializeNulls()
        .disableHtmlEscaping()
        .setPrettyPrinting()
        .create()
    return gson.toJson(json)
}

Utilisation du JSON avec GSON (suite et fin).

// Serialization
val gson = Gson()
val listType: Type = object : TypeToken<BookList?>() {}.type
val jsonResult: String = gson.toJson(bookList, listType)
Log.d(TAG, "onCreate jsonResult = $jsonResult")

Log.d(TAG, "onCreate jsonResult = ${jsonToPrettyFormat(jsonResult)}")

// Deserialization
val bookList2: BookList = Gson().fromJson(jsonResult, listType)
Log.d(TAG, "onCreate bookList2 = ${bookList2}")

Utiliser le presse-papier

TextView tvDemo = (TextView) findViewById(R.id.textview);
tvDemo.setOnLongClickListener(new View.OnLongClickListener() {
	@Override
	public boolean onLongClick(View v) {
		copyContentToClipboard("content", ((TextView)v).getText().toString());
		return true;
	}
});

findViewById<TextView>(R.id.textview).setOnLongClickListener(View.OnLongClickListener {
    copyContentToClipboard("label", (it as TextView).text.toString())
    return@OnLongClickListener true
})

App streaming

RenderScript

• Documentation officielle.
• Documentation.
• Getting Started With RenderScript on Android.
• Android : Simple and fast image processing with RenderScript.

MVVM

• Live data, ViewModel, Retrofit Android Architecture Component.
• MVVM (Model View ViewModel) + Kotlin + Google Jetpack.

RecyclerView

Sources

• Sources

handleUncaughtException

• Sources

Timber

• Timber

Décompiler un APK

• JADX
• Online
• Online
• WiKi
• APK Studio

Koin

• Introduction à l’injection.
• Kotlin Koin - Android Tutorial for Beginners - Step By Step Guide.
• Dependency Injection With Koin.
• Projet d'exemple.
• Aller plus loin.

run-as

adb exec-out run-as debuggable.app.package.name cat databases/file > file

adb exec-out run-as debuggable.app.package.name tar c databases/ > databases.tar
adb exec-out run-as debuggable.app.package.name tar c shared_prefs/ > shared_prefs.tar

> adb shell
shell $ run-as com.example.package
shell $ chmod 666 databases/file
shell $ exit                                               ## exit out of 'run-as'
shell $ cp /data/data/package.name/databases/file /sdcard/
shell $ run-as com.example.package
shell $ chmod 600 databases/file
> adb pull /sdcard/file .

Backup

adb backup -apk -shared -all -f <filepath>/backup.ab

adb restore <filepath>/backup.ab

adb backup -f "“"D:\myfolder\myapp.ab" -apk <package name>

java -jar "C:\ADB\android-backup-tookit\android-backup-extractor\android-backup-extractor-20180203-bin\abe.jar" unpack c:\adb\backup2.ab backup-extracted.tar  (You’ll be asked to enter the password)

Tools pour Android Studio