1.2 搭建开发环境
开发Compose要求Android Studio的版本在4.3及以上,而目前Android Studio最新的正式版本为4.2.2,所以我们需要使用Preview版本的Android Studio。如果读者在阅读本书时Android Studio稳定版本已经在4.3及以上,直接使用稳定版本的Android Studio即可。接下来我们一起搭建Compose的开发环境吧!
1.2.1 在Windows上搭建开发环境
鉴于目前大多数开发者使用Windows操作系统,所以首先介绍如何在Windows中安装Preview版本的Android Studio。进入Android Studio官网,页面如图1-1所示。
图1-1 下载Android Studio
点击左边“Beta build”下的下载按钮,会弹出如图1-2所示的对话框。
图1-2 下载Android Studio的对话框
需要勾选同意条款并点击下载按钮。之后需要做的就是等待下载了。这里无须选择下载版本(Windows或Mac),Google会判断你当前的系统并帮你下载适合的Android Studio版本。下载完成之后,选择在文件夹中打开,你会发现下载的是一个zip压缩包,直接进行解压。解压后如图1-3所示。
图1-3 Android Studio zip包解压
然后直接进入解压好的文件夹中的bin文件夹,如图1-4所示。
图1-4 Android Studio bin文件夹
接着双击图1-4中箭头所指的studio64.exe文件,会出现如图1-5所示的对话框。
图1-5 安装Android Studio
如果需要导入配置文件,可以选择第一项。这里我们直接选择不导入,之后点击“OK”按钮,然后就出现了熟悉的画面,如图1-6所示。
图1-6 Android Studio
等待几十秒后,会弹出如图1-7所示的对话框。
图1-7 Android Studio设置代理
这个对话框提醒你这是第一次运行Android Studio,当前无法访问Android SDK附加组件列表,询问你是否设置代理,如果需要,则点击“Setup Proxy”按钮。这里我们不需要设置代理,所以点击“Cancel”按钮。点击之后就进入了熟悉的欢迎页面,如图1-8所示。
图1-8 Android Studio欢迎页面
下面就简单了,直接点击“Next”按钮,此时会出现如图1-9所示的页面。
图1-9 Android Studio选择设置方式
在这个页面中,选择你想要的设置类型,默认的是“Standard”,它将帮助你安装一些预定的设置和选项。当然,也可以选择下面的“Custom”单选按钮进行自定义。这里我们选择“Standard”单选按钮,然后继续点击“Next”按钮,此时会出现如图1-10所示的页面。
图1-10 选择UI主题
这个页面是选择Android的UI主题,这就看大家的喜好了,我个人比较喜欢深色主题,所以就不改动了。继续点击“Next”按钮,此时会出现如图1-11所示的页面。
图1-11 下载SDK
这个页面提醒我们需要下载一些相关文件,比如模拟器、SDK等。直接点击“Finish”按钮,Android Studio会开始下载这些文件,如图1-12所示。
图1-12 Android Studio下载模拟器
下载完成之后,点击“Finish”按钮就可以进入Android Studio的首页了,如图1-13所示。
图1-13 Android Studio首页
至此,Windows Canary版本的Android Studio就下载并安装完成了,下一节将带大家安装Mac Canary版本的Android Studio。
1.2.2 在macOS上搭建开发环境
上一节带大家在Windows上搭建了Compose的开发环境,本节会带大家搭建macOS版本Android Studio的开发环境,赶快开始吧!
下载地址和Windows的一样,直接进入下载页面之后如图1-14所示。
图1-14 下载Mac版Android Studio
如前所述,Google会判断你当前的系统并帮你下载适合的Android Studio版本,刚才下载页面中显示的是for Windows,这里就是for Mac了。这里同样下载Canary版本的Android Studio,点击下载按钮也会弹出如图1-2所示的对话框。之后的操作这里就不赘述了,下载完成之后双击打开,接着选择下一步即可,和刚才在Windows中安装Android Studio的步骤一模一样。
1.2.3 将Compose添加到现有项目
如果想在现有项目中使用Compose,就需要为项目配置所需的设置和依赖项。
首先,需要配置Kotlin开发环境,Compose要求Kotlin的版本为1.4.30或更高:
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.5.20"
然后需要配置Gradle,需要将应用程序的最低API级别设置为21或更高级别,并在应用程序的build.gradle文件中启用Compose。另外,还要设置Kotlin编译器插件的版本。配置代码如下所示:
android { defaultConfig { applicationId "com.zj.five" minSdk 21 ...... } ...... compileOptions { sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 } kotlinOptions { jvmTarget = '1.8' useIR = true } buildFeatures { compose true // 打开Compose的开关 } composeOptions { // 设置Kotlin编译器插件版本 kotlinCompilerExtensionVersion compose_version kotlinCompilerVersion '1.5.20' } }
最后,还需要添加Compose的依赖:
dependencies { implementation 'androidx.compose.ui:ui:1.0.0' // UI工具包 implementation 'androidx.compose.ui:ui-tooling:1.0.0' // 基础(边框、背景、框、图片、滚动、形状、动画等) implementation 'androidx.compose.foundation:foundation:1.0.0' // Material Design implementation 'androidx.compose.material:material:1.0.0' // Material Design的图标 implementation 'androidx.compose.material:material-icons-core:1.0.0' implementation 'androidx.compose.material:material-icons-extended:1.0.0' // 与activity结合使用 implementation 'androidx.activity:activity-compose:1.3.0' // 与viewModel结合使用 implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0' // 与LiveData和RxJava2结合使用 implementation 'androidx.compose.runtime:runtime-livedata:1.0.0' implementation 'androidx.compose.runtime:runtime-rxjava2:1.0.0' // UI测试 androidTestImplementation 'androidx.compose.ui:ui-test-junit4:1.0.0' }
上面列出的依赖不必全部添加,大家可以根据项目的需要选择性添加。