Atención: soporte de desaplanado de API Java 8+ (Android Gradle Plugin 4.0.0+)
El desarrollo en esta biblioteca ( ThreeTenABP ) está terminando. Considere la posibilidad de cambiar a Android Gradle plugin 4.0, java.time. *, Y su función principal de eliminación de bibliotecas en los próximos meses.
Para habilitar la compatibilidad con estas API de idiomas 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:
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'
}
Primer descubrimiento: por qué debe usar ThreeTenABP en lugar de java.time , ThreeTen-Backport o incluso Joda-Time
Esta es una versión realmente corta del PROCESO MUY LARGO de definir un nuevo estándar. Todos estos paquetes son más o menos lo mismo: bibliotecas que proporcionan una funcionalidad de manejo moderna y buena para Java. Las diferencias son sutiles pero importantes.
La solución más obvia sería usar el java.timepaquete integrado , 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 era una nueva propuesta 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 en introducir las características 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 (en realidad no estoy seguro de que esto sea 100% cierto, pero así es como lo entiendo). Así 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 transfiere 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 y aparentemente correcta opción es ThreeTenABP .
Segundo descubrimiento: herramientas de compilación y gestión de dependencias
Dado que compilar un programa, especialmente uno que usa un montón de bibliotecas externas, es complejo, Java casi siempre usa una "herramienta de compilación" para administrar 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 señaló más abajo, Gradle es la herramienta de compilación elegida para proyectos de Android.
Estas herramientas de compilación incluyen 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's composercon Packagist y Ruby's gemcon rubygems.org. En otras palabras, el repositorio central de Maven es para Maven (y Gradle) lo que Packagist es para componer: una fuente definitiva y segura para paquetes versionados.
Tercer descubrimiento: Gradle maneja las dependencias en proyectos de Android
Lo más importante en mi 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 depósito 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 utiliza el repositorio central de Maven implícitamente a través del JCenter de Bintray, lo que significa que no tiene que hacer ninguna configuración adicional para configurar el repositorio: solo debe enumerar el dependencias
Cuarto descubrimiento: las dependencias del proyecto se enumeran en [dir del proyecto] /app/build.gradle
Una vez más, es obvio para aquellos que tienen experiencia en el uso de Gradle en Java, pero me tomó un tiempo resolver esto. Si ve personas que dicen "Oh, solo 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 es administrado por Jake Wharton, no por ThreeTen
Otro problema que pasé demasiado tiempo resolviendo. Si busca ThreeTen en Maven Central, solo verá paquetes para threetenbp, no threetenabp. Si va al repositorio de Github para ThreeTenABP , verá esa compile 'this-or-that'línea infame en la sección Descargar del archivo Léame.
Cuando llegué 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 eso 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, en oposición al org.threetenrepositorio. Es por eso que 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 modernas de manejo de tiempos 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'
}
Agregue también esto a la clase de aplicación:
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
AndroidThreeTen.init(this);
//...
}
}
