Cómo utilizar ThreeTenABP en el proyecto Android

Atención: esta respuesta, aunque técnicamente correcta, ya no está actualizada.

La compatibilidad con la eliminación de azúcar de la API de Java 8+ ahora está disponible a través del complemento Android Gradle 4.0.0+

(Vea también la respuesta de Basil Bourque a continuación )

El desarrollo de la biblioteca ThreeTenABP está llegando a su fin. Considere cambiar al complemento Android Gradle 4.0, java.time.*, y su función de desazucar de biblioteca principal en los próximos meses.

Para habilitar la compatibilidad con estas API de lenguaje en cualquier versión de la plataforma Android, actualice el complemento de Android a 4.0.0 (o superior) e incluya lo siguiente en el archivo build.gradle de su módulo (de esta sección de la página de soporte de Java 8 en Sitio de desarrolladores de Android , que también tiene información adicional sobre cómo desazucarar):

android {
  defaultConfig {
    // Required when setting minSdkVersion to 20 or lower
    multiDexEnabled true
  }

  compileOptions {
    // Flag to enable support for the new language APIs
    coreLibraryDesugaringEnabled true
    // Sets Java compatibility to Java 8
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
}

dependencies {
  coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.0.5'
}

Respuesta original

Primer descubrimiento: por qué debe utilizar ThreeTenABP en lugar de java.time , ThreeTen-Backport o incluso Joda-Time

Esta es una versión realmente corta del MUY LARGO PROCESO de definir un nuevo estándar. Todos estos paquetes son más o menos lo mismo: bibliotecas que proporcionan una buena y moderna funcionalidad de manejo para Java. Las diferencias son sutiles pero importantes.

La solución más obvia sería utilizar el paquete integrado java.time, ya que esta es la nueva forma estándar de manejar la hora y las fechas en Java. Es una implementación de JSR 310 , que fue una nueva propuesta de estándar para el manejo del tiempo basada en la biblioteca Joda-Time .

Sin embargo, java.timese introdujo en Java 8 . Android hasta Marshmallow se ejecuta en Java 7 ("Android N" es la primera versión que introduce las funciones del lenguaje Java 8). Por lo tanto, a menos que solo esté apuntando a Android N Nougat y superior, no puede confiar en las características del lenguaje Java 8 (no estoy realmente seguro de que esto sea 100% cierto, pero así es como lo entiendo). Así que java.timeestá fuera.

La siguiente opción podría ser Joda-Time , ya que JSR 310 se basó en Joda-Time. Sin embargo, como indica el archivo Léame de ThreeTenABP , por varias razones, Joda-Time no es la mejor opción.

El siguiente es ThreeTen-Backport , que traslada gran parte (pero no toda) de la java.timefuncionalidad de Java 8 a Java 7. Esto está bien para la mayoría de los casos de uso, pero, como se indica en el archivo Léame de ThreeTenABP , tiene problemas de rendimiento con Android.

Entonces la última opción y aparentemente correcta es ThreeTenABP .

Segundo descubrimiento: herramientas de compilación y gestión de dependencias

Dado que compilar un programa (especialmente uno que utiliza un montón de bibliotecas externas) es complejo, Java casi invariablemente utiliza una "herramienta de compilación" para gestionar el proceso. Make , Apache Ant , Apache Maven y Gradle son herramientas de compilación que se utilizan con programas Java (consulte esta publicación para ver comparaciones). Como se indica más adelante, Gradle es la herramienta de compilación elegida para proyectos de Android.

Estas herramientas de compilación incluyen la gestión de dependencias. Apache Maven parece ser el primero en incluir un repositorio de paquetes centralizado. Maven presentó el Repositorio Central de Maven , que permite una funcionalidad equivalente a php composercon Packagist y Ruby gemcon rubygems.org. En otras palabras, el Repositorio Central de Maven es para Maven (y Gradle) lo que Packagist es para Composer: una fuente definitiva y segura para paquetes versionados.

Tercer descubrimiento: Gradle maneja las dependencias en proyectos de Android

Una de mis prioridades en la lista de tareas pendientes es leer los documentos de Gradle aquí , incluidos sus libros electrónicos gratuitos. Si hubiera leído estas semanas cuando comencé a aprender Android, seguramente habría sabido que Gradle puede usar el Repositorio Central de Maven para administrar dependencias en Proyectos de Android. Además, como se detalla en esta respuesta de StackOverflow, a partir de Android Studio 0.8.9, Gradle usa el repositorio central de Maven implícitamente a través del JCenter de Bintray, lo que significa que no tiene que realizar ninguna configuración adicional para configurar el repositorio: simplemente enumera el dependencias.

Cuarto descubrimiento: las dependencias del proyecto se enumeran en [directorio del proyecto]/app/build.gradle

Nuevamente, es obvio para aquellos que tienen alguna experiencia en el uso de Gradle en Java, pero me tomó un tiempo darme cuenta de esto. Si ve gente que dice "Oh, simplemente agregue compile 'this-or-that.jar'" o algo similar, sepa que compilehay una directiva en ese archivo build.gradle que indica dependencias en tiempo de compilación. Aquí está la página oficial de Gradle sobre gestión de dependencias.

Quinto descubrimiento: ThreeTenABP está gestionado por Jake Wharton, no por ThreeTen

Otro problema más en el que pasé demasiado tiempo resolviendo. Si busca ThreeTen en Maven Central, solo verá paquetes para threetenbp, no para threetenabp. Si va al repositorio de github de ThreeTenABP , verá esa infame compile 'this-or-that'línea en la sección Descargar del archivo Léame.

Cuando accedí por primera vez a este repositorio de github, no sabía qué significaba esa línea de compilación e intenté ejecutarla en mi terminal (con un error obvio y predecible). Frustrado, no volví a él hasta mucho después de que descubrí el resto y finalmente me di cuenta de que es una línea de Maven Repo que apunta al com.jakewharton.threetenabprepositorio, a diferencia del org.threetenrepositorio. Por eso pensé que el paquete ThreeTenABP no estaba en el repositorio de Maven.

Resumen: Hacer que funcione

Ahora todo parece bastante fácil. Puede obtener funciones de manejo modernas en un proyecto de Android asegurándose de que su [project folder]/app/build.gradlearchivo tenga la implementation 'com.jakewharton.threetenabp:threetenabp:1.2.1'línea en su dependenciessección:

apply plugin: 'com.android.application'

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.3"

    defaultConfig {
        applicationId "me.ahuman.myapp"
        minSdkVersion 11
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}


dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    testImplementation 'junit:junit:4.12'
    implementation 'com.android.support:appcompat-v7:23.4.0'
    implementation 'com.android.support:design:23.4.0'
    implementation 'com.jakewharton.threetenabp:threetenabp:1.2.1'
}

También agregue esto a la clase de Aplicación:

public class App extends Application {    
    @Override
    public void onCreate() {
        super.onCreate();
        AndroidThreeTen.init(this);
        //...
    }
}

Aug 12 '2016 16:08 kael