注意:Java 8+ API终止代理支持(Android Gradle Plugin 4.0.0+)
这个库(ThreeTenABP)的开发工作正在逐渐减少。请考虑在接下来的几个月中切换到Android Gradle插件4.0,java.time。*及其核心库终止功能。
要在任何版本的Android平台上启用对这些语言API的支持,请将Android插件更新为4.0.0(或更高版本),并在模块的build.gradle文件中包括以下内容:
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'
}
第一个发现:为什么必须使用ThreeTenABP代替java.time,ThreeTen-Backport甚至是Joda-Time
这是定义新标准的非常长的过程的简短版本。所有这些软件包几乎都是相同的:库为Java提供了良好的现代时间处理功能。差异微妙但重要。
最明显的解决方案是使用内置java.time
软件包,因为这是Java中处理时间和日期的新标准方法。它是JSR 310的实现,它是基于Joda-Time库的时间处理的新标准建议。
但是,java.time
是在Java 8中引入的。高达棉花糖的 Android 在Java 7上运行(“ Android N”是引入Java 8语言功能的第一个版本)。因此,除非您仅针对Android N Nougat和更高版本,否则您不能依赖Java 8语言功能(我不确定这是否100%正确,但这是我的理解)。所以,java.time
是的。
下一个选项可能是Joda-Time,因为JSR 310是基于Joda-Time的。但是,正如ThreeTenABP自述文件所指出的,出于多种原因,Joda-Time并不是最佳选择。
接下来是ThreeTen-Backport,它将大部分(但不是全部)Java 8 java.time
功能反向移植到Java7。这对于大多数用例来说都很好,但是,正如ThreeTenABP自述文件所述,它在Android上存在性能问题。
因此,最后一个看似正确的选项是ThreeTenABP。
第二次发现:构建工具和依赖管理
由于编译程序(尤其是使用一堆外部库的程序)非常复杂,因此Java几乎总是使用“构建工具”来管理程序。Make,Apache Ant,Apache Maven和Gradle都是与Java程序一起使用的构建工具(请参阅本帖子以进行比较)。如后面所述,Gradle是Android项目的首选构建工具。
这些构建工具包括依赖项管理。Apache Maven似乎是第一个包含集中式软件包存储库的仓库。Maven引入了Maven中央存储库,该库允许composer
使用与Packagist的php 和gem
rubygems.org的Ruby 等效的功能。换句话说,Maven中央存储库是Maven(和Gradle)对Packagist的构想,它是版本包的权威性和安全性来源。
第三次发现:Android项目中的Gradle处理依赖项
在我的待办事项清单中,最重要的是在此处阅读Gradle文档,包括其免费电子书。如果这些星期前我开始学习Android时就读过,那么我肯定会知道Gradle可以使用Maven Central信息库来管理Android项目中的依赖项。此外,正如此 StackOverflow答案中所详述的那样,从Android Studio 0.8.9开始,Gradle通过Bintray的JCenter隐式使用Maven Central Repository,这意味着您不必做任何额外的配置即可设置存储库-您只需列出依赖性。
第四个发现:项目依赖性在[project dir] /app/build.gradle中列出
同样,对于那些在Java中使用Gradle有任何经验的人来说是显而易见的,但是花了我一段时间才弄清楚了。如果您看到有人说“哦,只需添加compile 'this-or-that.jar'
”或类似内容,请知道那compile
是该build.gradle文件中的指示编译时依赖性的指令。这是有关依赖管理的官方Gradle页面。
第五发现:ThreeTenABP由Jake Wharton管理,而不由ThreeTen管理
我花了太多时间弄清楚另一个问题。如果您在Maven Central中寻找ThreeTen,则只会看到的软件包threetenbp
,而不会看到threetenabp
。如果转到ThreeTenABP的github存储库,您将compile 'this-or-that'
在自述文件的“下载”部分看到该臭名昭著的行。
当我第一次访问此github存储库时,我不知道该编译行的含义,因此我尝试在终端中运行它(出现明显且可预测的故障)。沮丧的是,直到弄清其余部分后,我才回到很长一段时间,最后才意识到这是指向com.jakewharton.threetenabp
回购协议的Maven回购协议行,而不是org.threeten
回购协议。这就是为什么我认为ThreeTenABP软件包不在Maven存储库中。
摘要:使之工作
现在,一切似乎都很容易。您可以通过确保[project folder]/app/build.gradle
文件中包含implementation 'com.jakewharton.threetenabp:threetenabp:1.2.1'
以下dependencies
部分的行来获得Android项目中的现代时间处理功能:
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'
}
还将其添加到Application类:
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
AndroidThreeTen.init(this);
//...
}
}