(转)Android Jetpack Compose 最全上手指南

2024-03-27 07:08
文章标签 android compose 最全 手指 jetpack

本文主要是介绍(转)Android Jetpack Compose 最全上手指南，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

在今年的Google/IO大会上，亮相了一个全新的 Android 原生 UI 开发框架-Jetpack Compose, 与苹果的SwiftIUI一样，Jetpack Compose是一个声明式的UI框架，随着了今年安卓和苹果两大移动平台相继推出自己的UI开发框架Jetpack Compose 和SwiftIUI，标志着移动操作系统正式全面拥抱声明式 UI 开发模式。

一、声明式 UI 的前世今生

其实声明式 UI 并不是什么新技术，早在 2006 年，微软就已经发布了其新一代界面开发框架 WPF，其采用了 XAML 标记语言，支持双向数据绑定、可复用模板等特性。

2010 年，由诺基亚领导的 Qt 团队也正式发布了其下一代界面解决方案 Qt Quick，同样也是声明式，甚至 Qt Quick 起初的名字就是 Qt Declarative。QML 语言同样支持数据绑定、模块化等特性，此外还支持内置 JavaScript，开发者只用 QML 就可以开发出简单的带交互的原型应用。

声明式 UI 框架近年来飞速发展，并且被 Web 开发带向高潮。React 更是为声明式 UI 奠定了坚实基础并一直引领其未来的发展。随后 Flutter 的发布也将声明式 UI 的思想成功带到移动端开发领域...

声明式UI的意思就是，描述你想要一个什么样的UI界面，状态变化时，界面按照先前描述的重新“渲染”即可得到状态绝对正确的界面，而不用像命令一样，告诉程序一步一步该干什么，维护各种状态。扯远了，这个并不是今天文章的重点，稍微了解一下就好，其他的就不在本文延伸。关于声明式的更多介绍，建议看看这篇文章：zhuanlan.zhihu.com/p/68275232

我们回到本文的重点Jetpack Compose。

二、Jetpack Compose 介绍

Jetpack Compose 是一个用于构建原生Android UI 的现代化工具包，它基于声明式的编程模型，因此你可以简单地描述UI的外观，而Compose则负责其余的工作-当状态发生改变时，你的UI将自动更新。由于Compose基于Kotlin构建，因此可以与Java编程语言完全互操作，并且可以直接访问所有Android和Jetpack API。它与现有的UI工具包也是完全兼容的，因此你可以混合原来的View和现在新的View，并且从一开始就使用Material和动画进行设计。

三、Jetpack Compose 环境准备和Hello World

每当我们学习一门新的语言，我们都是从一个hello world开始，今天我们也从一个hello world来开始Jetpack Compose 吧! 要想获得Jetpack Compose 的最佳体验，我们需要下载最新版本的Android Studio 预览版本（即Android Studio 4.0）。因为Android Studio 4.0 添加了对Jetpack Compose 的支持，如新的Compose 模版和Compose 及时预览。

Android Studio 4.0.png

使用Jetpack Compose 来开始你的开发工作有2种方式：

  • 将Jetpack Compose 添加到现有项目
  • 创建一个支持Jetpack Compose的新应用

接下来分别介绍一下这两种方式。

1. 将Jetpack Compose 添加到现有项目

如果你想在现有的项目中使用Jetpack Compose，你需要配置一些必须的设置和依赖：

（1）gradle 配置

在app目录下的build.gradle 中将app支持的最低API 版本设置为21或更高，同时开启Jetpack Compose enable开关，代码如下：

android {defaultConfig {...minSdkVersion 21}buildFeatures {// Enables Jetpack Compose for this modulecompose true}...// Set both the Java and Kotlin compilers to target Java 8.compileOptions {sourceCompatibility JavaVersion.VERSION_1_8targetCompatibility JavaVersion.VERSION_1_8}kotlinOptions {jvmTarget = "1.8"}
}

(2) 使用试验版Kotlin-Gradle 插件

Jetpack Compose 需要试验版的Kotlin-Gradle插件,在根目录下的build.gradle添加如下代码：

buildscript {repositories {google()jcenter()// To download the required version of the Kotlin-Gradle plugin,// add the following repository.maven { url 'https://dl.bintray.com/kotlin/kotlin-eap' }...dependencies {classpath 'com.android.tools.build:gradle:4.0.0-alpha01'classpath 'org.jetbrains.kotlin:kotlin-gradle-plugin:1.3.60-eap-25'}
}allprojects {repositories {google()jcenter()maven { url 'https://dl.bintray.com/kotlin/kotlin-eap' }}
}

(3) 添加Jetpack Compose工具包依赖项

在app目录下的build.gradle添加Jetpack Compose 工具包依赖项，代码如下：

dependencies {// You also need to include the following Compose toolkit dependencies.implementation 'androidx.ui:ui-tooling:0.1.0-dev02'implementation 'androidx.ui:ui-layout:0.1.0-dev02'implementation 'androidx.ui:ui-material:0.1.0-dev02'...
}

ok，到这儿准备工作就完毕，就可以开始写代码了，但是前面说了，还有一种方式接入Jetpack Compose ,我们来一起看看。

2. 创建一个支持Jetpack Compose的新应用

比起在现有应用中接入Jetpack Compose ,创建一个支持Jetpack Compose 的新项目则简单了许多，因为Android Studio 4.0 提供了一个新的Compose 模版，只要选择这个模版创建应用，则所有上面的那些配置项都自动帮我们完成了。

创建一个支持Jetpack Compose 的应用，如下几个步骤就可以了：

    1. 如果你在Android Studio的欢迎窗口，点击Start a new Android Studio project，如果你已经打开了Android Studio 项目，则在顶部菜单栏选择File > New > New Project
    1. 在Select a Project Template 窗口，选择Empty Compose Activity并且点击下一步
    1. 在Configure your project 窗口，做如下几步：
    • a. 设置项目名称, 包名和保存位置
    • b. 注意，在语言下来菜单中，Kotlin 是唯一一个可选项，因为Jetpack Compose 只能用Kotlin来写的才能运行。
    • c. Minimum API level 下拉菜单中，选择21或者更高
    1. 点击Finish

现在，你就可以使用Jetpack Compose 来编写你的应用了。

3. Hello wold

在MainActivity.kt中添加如下代码：

class MainActivity : AppCompatActivity() {override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContent {Text("Hello, Android技术杂货铺")}}
}

hello.png

Jetpack Compose是围绕composable函数来构建的。这些函数使你可以通过描述应用程序的形状和数据依赖，以编程方式定义应用程序的UI，而不是着眼于UI的构建过程。要创建composable函数，只需要在函数名前面加上一个@composable注解即可, 上面的Text就是一个composable函数。

4. 定义一个composable函数

一个composable函数只能在另一个composable函数的作用域里北调用，要使一个函数变为composable函数，只需在函数名前加上@composable注解，我们把上面的代码中，setContent中的部分移到外面，抽取到一个composable函数中，然后传递一个参数name 给 text元素。

class MainActivity : AppCompatActivity() {override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContent {Greeting("Android技术杂货铺")}}
}@Composable
fun Greeting(name: String) {Text(text = "Hello $name!")
}

四、布局

UI元素是分层级的，元素包含在其他元素中。在Jetpack Compose中，你可以通过从其他composable函数中调composable函数来构建UI层次结构。

UI.png

在Android的xml布局中，如果要显示一个垂直结构的布局，最长用的就是LinearLayout, 设置android:orientation 值为vertical, 子元素就会垂直排列，那么，在Jetpack Compose 中，如何来实现垂直布局呢？先添加几个Text来看一下。

1. 添加多个Text

在上面的例子中，我们添加了一个Text显示文本，现在我们添加三个文本，代码如下：

class MainActivity : AppCompatActivity() {override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContent {NewsStory()}}
}@Composable
fun NewsStory() {Text("我超❤️JetPack Compose的！")Text("Android技术杂货铺")Text("依然范特西")
}

image.png

从上图可以看到，我们添加了3个文本，但是，由于我们还没有提供有关如何排列它们的任何信息，因此三个文本元素相互重叠绘制，使得文本不可读。

2. 使用Column

要使重叠绘制的Text文本能够垂直排列，我们就需要使用到Column函数，写过flutter的同学看起来是不是很眼熟？是的，跟flutter里面的Column Widget 名字和功能完全一样，甚至连他们的属性都一摸一样。

@Composable
fun NewsStory() {Column { //  添加Column，使布局垂直排列Text("我超❤️JetPack Compose的！")Text("Android技术杂货铺")Text("依然范特西")}
}

效果如下：

Column.png

可以看到，前面重叠的布局，现在已经垂直排列了，但是，默认情况下，从左上角开始，一个接一个的排列，没有任何间距。接下来，我们给Column 设置一些样式。

3. 给Column添加样式

在调用Column（）时，可以传递参数给Column（）来配置Column的大小、位置以及设置子元素的排列方式。

@Composable
fun NewsStory() {Column (crossAxisSize = LayoutSize.Expand,modifier = Spacing(16.dp)){ //  添加Column，使布局垂直排列Text("我超❤️JetPack Compose的！")Text("Android技术杂货铺")Text("依然范特西")}
}

image.png

如上图所示，我们填充了padding，其他效果几乎一摸一样， 上面代码中的设置属性解释如下：

  •  crossAxisSize: 指定Column组件（注：Compose中，所有的组件都是composable函数，文中的组件都是指代composable函数）在水平方向的大小，设置 crossAxisSize为LayoutSize.Expand即表示Column宽度应为其父组件允许的最大宽度，相当于传统布局中的match_parant ，还有一个值为LayoutSize.Wrap，看名字就知道，包裹内容，相当于传统布局中的wrap_content。

  • modifier:使你可以进行其他格式更改。在这种情况下，我们将应用一个Spacing修改器，该设置将Cloumn与周围的视图产生间距。

4. 如何显示一张图片？

在原来的安卓原生布局中，显示图片有相应的控件ImageView,设置本地图片地址或者Bitmap就能展示，在Jetpack Compose 中该如何显示图片呢？

header.png

我们先下载这张图片到本地，添加到资源管理器中，命名为header.png, 我们更改一下上面的NewsStory ()方法，先从资源文件夹获取图片image，然后通过DrawImage()将图片绘制出来：

@Composable
fun NewsStory() {// 获取图片val image = +imageResource(R.mipmap.header)Column (crossAxisSize = LayoutSize.Expand,modifier = Spacing(16.dp)){ //  添加Column，使布局垂直排列// 显示图片DrawImage(image)Text("我超❤️JetPack Compose的！")Text("Android技术杂货铺")Text("依然范特西")}
}

image.png

可以看到，图片不会按正确的比列显示，接下来，我们来修复它。

图片已添加到布局中，但会展开以填充整个视图，并和文本是拼叠排列，文字显示在上层。要设置图形样式，请将其放入Container(又一个和flutter中一样的控件)

  • Container: 一个通用的内容对象，用于保存和安排其他UI元素。然后，你可以将大小和位置的设置应用于容器。
@Composable
fun NewsStory() {// 获取图片val image = +imageResource(R.mipmap.header)Column (crossAxisSize = LayoutSize.Expand,modifier = Spacing(16.dp)){ //  添加Column，使布局垂直排列// 放在容器中，设置大小Container(expanded = true, height = 180.dp) {// 显示图片DrawImage(image)}Text("我超❤️JetPack Compose的！")Text("Android技术杂货铺")Text("依然范特西")}
}

image.png

  • expanded : 指定Container的大小，默认是false（Container的大小是子组件的大小，相当于wrap_content），如果将它设置为true，就指定Container的大小为父控件所允许的最大size, 相当于match_parent。

  • height : 设置Container容器的高度，height属性的优先级高于expanded,因此会覆盖expanded，如上面的例子，设置height为180dp,也就是容器宽为父控件宽度，高为180dp

5. 添加间距Spacer

我们看到，图片和文本之间没有间距，传统布局中，我们可以添加Margin属性，设置间距，在Jetpack Compose 中，我们可以使用HeightSpacer()和WidthSpacer() 来设置垂直和水平间距

 HeightSpacer(height = 20.dp) //设置垂直间距20dpWidthSpacer(width = 20.dp) // 设置水平间距20dp

在上面的例子中，我们来为图片和文本之间添加20dp的间距：

@Composable
fun NewsStory() {// 获取图片val image = +imageResource(R.mipmap.header)Column (crossAxisSize = LayoutSize.Expand,modifier = Spacing(16.dp)){ //  添加Column，使布局垂直排列// 放在容器中，设置大小Container(expanded = true, height = 180.dp) {// 显示图片DrawImage(image)}HeightSpacer(height = 20.dp) // 添加垂直方向间距20dpText("我超❤️JetPack Compose的！")Text("Android技术杂货铺")Text("依然范特西")}
}

image.png

五、使用Material design 设计

Compose 旨在支持Material Design 设计原则，许多组件都实现了Material Design 设计，可以开箱即用，在这一节中，将使用一些Material小组件来对app进行样式设置

1. 添加Shape样式

Shape是Material Design 系统中的支柱之一，我们来用clip函数对图片进行圆角裁剪。

@Composable
fun NewsStory() {// 获取图片val image = +imageResource(R.mipmap.header)Column (crossAxisSize = LayoutSize.Expand,modifier = Spacing(16.dp)){ //  添加Column，使布局垂直排列// 放在容器中，设置大小Container(expanded = true, height = 180.dp) {Clip(shape = RoundedCornerShape(10.dp)) {// 显示图片DrawImage(image)}           }HeightSpacer(height = 20.dp) // 添加垂直方向间距20dpText("我超❤️JetPack Compose的！")Text("Android技术杂货铺")Text("依然范特西")}
}

形状是不可见的，但是我们的图片已经被裁剪了成了设置的形状样式，因此如上图，图片已经有圆角了。

2. 给Text 添加一些样式

通过Compose，可以轻松利用Material Design原则。将MaterialTheme（）应用于创建的组件

@Composable
fun NewsStory() {// 获取图片val image = +imageResource(R.mipmap.header)// 使用Material Design 设计MaterialTheme() {Column (crossAxisSize = LayoutSize.Expand,modifier = Spacing(16.dp)){ //  添加Column，使布局垂直排列// 放在容器中，设置大小Container(expanded = true, height = 180.dp) {Clip(shape = RoundedCornerShape(10.dp)) {// 显示图片DrawImage(image)}}HeightSpacer(height = 20.dp) // 添加垂直方向间距20dpText("我超❤️JetPack Compose的！")Text("Android技术杂货铺")Text("依然范特西")}  }
}

如上面的代码，添加了MaterialTheme后，重新运行，效果没有任何变化，文本现在使用了MaterialTheme的默认文本样式。接下来，我们将特定的段落样式应用于每个文本元素。

@Composable
fun NewsStory() {// 获取图片val image = +imageResource(R.mipmap.header)// 使用Material Design 设计MaterialTheme() {Column (crossAxisSize = LayoutSize.Expand,modifier = Spacing(16.dp)){ //  添加Column，使布局垂直排列// 放在容器中，设置大小Container(expanded = true, height = 180.dp) {Clip(shape = RoundedCornerShape(10.dp)) {// 显示图片DrawImage(image)}}HeightSpacer(height = 20.dp) // 添加垂直方向间距20dpText("我超❤️JetPack Compose的！", style = +themeTextStyle { h5 }) // 注意添加了styleText("Android技术杂货铺", style = +themeTextStyle { body1 }) // 注意添加了styleText("依然范特西", style = +themeTextStyle { body2 }) // 注意添加了style}}
}

现在看看，我们的文本样式已经有变化了，标题有6中样式 h1-h6，其实HTML中的样式很像，内容文本有body1和body22中样式。

Material 调色版使用了一些基本颜色，如果要强调文本，可以调整文本的不透明度:

Text("我超❤️JetPack Compose的！", style = (+themeTextStyle { h5 }).withOpacity(0.87f))
Text("Android技术杂货铺", style = (+themeTextStyle { body1 }).withOpacity(0.87f))
Text("依然范特西", style = (+themeTextStyle { body2 }).withOpacity(0.6f))

有些时候，标题很长，但是我们又不想长标题换行从而影响我们的app UI ,因此，我们可以设置文本的最大显示行数,超过部分就截断。

如本例所示，我们设置显示最大行数为2，多于的部分截断处理：

  Text("我超❤️JetPack Compose的！写起来简单，复用性又强，可以抽取很多组件来复用，不用管理复杂的状态变更！", maxLines = 2, overflow = TextOverflow.Ellipsis, style = (+themeTextStyle { h5 }).withOpacity(0.87f))

可以看到，设置了maxLines 和overflow 之后，超出部分就截断处理了，不会影响到整个布局样式。

六、Compose 布局实时预览

从Android Studio 4.0 开始，提供了在IDE中预览composable函数的功能，不用像以前那样，要先下载一个模拟器，然后将app状态模拟器上，运行app才能看到效果。

但是有一个限制，那就是composable函数不能有参数

满足下面两个条件：

  • 函数没有参数
  • 在函数前面添加@Preview注解

预览效果图如下：

当布局改变了之后，顶部会出现一个导航条，显示预览已经过期，点击build&Refresh就可以刷新预览

这真的是一个非常棒的功能，像其他声明式布局，如React 、flutter 是没有这个功能的，布局了之后，要重新运行才能看到效果，虽然可以热启动，但是还是没有这个预览来得直接。

还有一个非常牛逼的地方是，compose 的预览可以同时预览多个composable函数。

效果如下：

七、总结

Jetpack Compse 目前还是试验版,所以肯定还存在很多问题，还不能现在将其用于商业项目中，但是这并不能妨碍我们学习和体验它，声明式 UI 框架近年来飞速发展，React 为声明式 UI 奠定了坚实基础并。 Flutter 的发布将声明式 UI 的思想成功带到移动端开发领域，Apple和Google 分别先后发布了自己的声明式UI框架SwiftUI 和 Jetpack Compose , 以后，原生UI布局，声明式可能将会是主流。

以上就是本文的所有内容，希望它对你有用！

如果你喜欢我的文章，就关注下我的公众号 Android技术杂货铺 、 简书 或者Github！ 微信公众号：Android技术杂货铺

简书：www.jianshu.com/u/35167a70a…

GitHub：github.com/pinguo-zhou…

这篇关于(转)Android Jetpack Compose 最全上手指南的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/851297。

相关文章

Android实现任意版本设置默认的锁屏壁纸和桌面壁纸（两张壁纸可不一致）

Android实现任意版本设置默认的锁屏壁纸和桌面壁纸（两张壁纸可不一致）

客户有些需求需要设置默认壁纸和锁屏壁纸  在默认情况下 这两个壁纸是相同的  如果需要默认的锁屏壁纸和桌面壁纸不一样 需要额外修改 Android13实现 替换默认桌面壁纸： 将图片文件替换frameworks/base/core/res/res/drawable-nodpi/default_wallpaper.*  （注意不能是bmp格式） 替换默认锁屏壁纸： 将图片资源放入vendo
阅读更多...
Android平台播放RTSP流的几种方案探究（VLC VS ExoPlayer VS SmartPlayer）

Android平台播放RTSP流的几种方案探究（VLC VS ExoPlayer VS SmartPlayer）

技术背景 好多开发者需要遴选Android平台RTSP直播播放器的时候，不知道如何选的好，本文针对常用的方案，做个大概的说明： 1. 使用VLC for Android VLC Media Player（VLC多媒体播放器），最初命名为VideoLAN客户端，是VideoLAN品牌产品，是VideoLAN计划的多媒体播放器。它支持众多音频与视频解码器及文件格式，并支持DVD影音光盘，VCD影
阅读更多...
android-opencv-jni

android-opencv-jni

//------------------start opencv--------------------@Override public void onResume(){ super.onResume(); //通过OpenCV引擎服务加载并初始化OpenCV类库，所谓OpenCV引擎服务即是 //OpenCV_2.4.3.2_Manager_2.4_*.apk程序包，存
阅读更多...
从状态管理到性能优化：全面解析 Android Compose

从状态管理到性能优化：全面解析 Android Compose

文章目录 引言一、Android Compose基本概念1.1 什么是Android Compose?1.2 Compose的优势1.3 如何在项目中使用Compose 二、Compose中的状态管理2.1 状态管理的重要性2.2 Compose中的状态和数据流2.3 使用State和MutableState处理状态2.4 通过ViewModel进行状态管理 三、Compose中的列表和滚动
阅读更多...
Android 10.0 mtk平板camera2横屏预览旋转90度横屏拍照图片旋转90度功能实现

Android 10.0 mtk平板camera2横屏预览旋转90度横屏拍照图片旋转90度功能实现

1.前言 在10.0的系统rom定制化开发中，在进行一些平板等默认横屏的设备开发的过程中，需要在进入camera2的 时候，默认预览图像也是需要横屏显示的，在上一篇已经实现了横屏预览功能，然后发现横屏预览后，拍照保存的图片 依然是竖屏的，所以说同样需要将图片也保存为横屏图标了，所以就需要看下mtk的camera2的相关横屏保存图片功能， 如何实现实现横屏保存图片功能 如图所示: 2.mtk
阅读更多...
android应用中res目录说明

android应用中res目录说明

Android应用的res目录是一个特殊的项目，该项目里存放了Android应用所用的全部资源，包括图片、字符串、颜色、尺寸、样式等，类似于web开发中的public目录，js、css、image、style。。。。 Android按照约定，将不同的资源放在不同的文件夹中，这样可以方便的让AAPT(即Android Asset Packaging Tool , 在SDK的build-tools目
阅读更多...
Android fill_parent、match_parent、wrap_content三者的作用及区别

Android fill_parent、match_parent、wrap_content三者的作用及区别

这三个属性都是用来适应视图的水平或者垂直大小，以视图的内容或尺寸为基础的布局，比精确的指定视图的范围更加方便。 1、fill_parent 设置一个视图的布局为fill_parent将强制性的使视图扩展至它父元素的大小 2、match_parent 和fill_parent一样，从字面上的意思match_parent更贴切一些，于是从2.2开始，两个属性都可以使用，但2.3版本以后的建议使
阅读更多...
Android Environment 获取的路径问题

Android Environment 获取的路径问题

1. 以获取 /System 路径为例 /*** Return root of the "system" partition holding the core Android OS.* Always present and mounted read-only.*/public static @NonNull File getRootDirectory() {return DIR_ANDR
阅读更多...
Android逆向(反调，脱壳，过ssl证书脚本)

Android逆向(反调，脱壳，过ssl证书脚本)

文章目录 总结 基础Android基础工具 定位关键代码页面activity定位数据包参数定位堆栈追踪 编写反调脱壳好用的脚本过ssl证书校验抓包反调的脚本打印堆栈bilibili反调的脚本 总结 暑假做了两个月的Android逆向，记录一下自己学到的东西。对于app渗透有了一些思路。 这两个月主要做的是代码分析，对于分析完后的持久化等没有学习。主要是如何反编译源码，如何找到
阅读更多...
android系统源码12 修改默认桌面壁纸--SRO方式

android系统源码12 修改默认桌面壁纸--SRO方式

1、aosp12修改默认桌面壁纸 代码路径 ：frameworks\base\core\res\res\drawable-nodpi 替换成自己的图片即可，不过需要覆盖所有目录下的图片。 由于是静态修改，则需要make一下，重新编译。 2、方法二Overlay方式 由于上述方法有很大缺点，修改多了之后容易遗忘自己修改哪些文件，为此我们采用另外一种方法，使用Overlay方式。
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2