在 HarmonyOS 中实现 CircleImageView 库

2022 年 5 月 04 日
本文字数：2915 字
阅读完需：约 10 分钟

你是否希望在 HarmonyOS 中为你的应用程序创建一个非常干净和圆润的配置文件图像，那么我们已经为你提供服务。在本文中，我们将向你介绍在 HarmonyOS 中创建的 CircleImageView 库，并指导你基于它创建简单的应用程序是多么容易。让我们开始吧。

CircleImageView 是一个非常易于使用且功能强大的库。即使在世界上最新的操作系统之一 HarmonyOS! 上运行，该库的性能也非常好。CircleImageView 不仅涵盖了以圆形格式显示图像，我们还可以包含一些其他属性。下面列出了其中的一些。

1.创建具有指定边框（颜色、宽度）值的圆形图像 2.你可以调整图像的亮度/对比度以及透明度值（alpha）3.提供图像的不同方式，如 URI、资源 ID、PixelMap、PixelMapElement 等。

在我们继续之前，我肯定想强调一下激发我们灵感的原始 CircleImageView 包 (de.hdodenhof:circleimageview)，并轻松移植到 HarmonyOS。你可以考虑多种用例

将其用作单个配置文件图像
将其用作联系人页面中的联系人图像。
如果你一直在使用任何聊天应用程序，那么你肯定遇到过列表视图格式的个人资料图像，而 CircleImageView 最适合你。

现在我们知道了 CircleImageView 可以用来做什么，现在让我们看看如何实现并开始创建简单的创新应用程序。

分步实施

第 1 步：这里我们将使用专门为运行 HarmonyOS 应用程序而设计的 DevEco studio IDE，如果你还没有安装，那么你可以从 SDK 的官方链接获取它。此外，我们在此处提供了环境设置的分步说明。

第 2 步： DevEco Studio 启动后，你可以创建一个选择“文件”-> 新建 -> 新建项目选项，然后你会看到多个模板可供选择，选择如下所示的模板，即 Empty Ability .

第 3 步：下一步，你必须使用项目详细信息、路径和确保选择 “配置项目”

语言如 Java
API 版本为 5

第 4 步：完成初始设置后，你就可以开始使用该应用程序了。

第 5 步：接下来添加 CircleImageView 依赖项，为了在你的 HarmonyOS 移动应用程序中使用该库，你需要首先通过在 entry/build.gradle 文件中添加以下依赖项来安装它。

dependencies {
   implementation fileTree(dir: 'libs', include: ['*.har'])
   implementation 'io.openharmony.tpc.thirdlib:circleimageview:1.0.0'
   testCompile 'junit:junit:4.12'
}

复制代码

第 6 步：添加依赖后，让我们定义布局文件，你可以通过导航到以下路径“entry” -> src-> resources ->base -> layout ->ability_main.xml 找到布局

在 ability_main.xml 添加以下代码

<?xml version="1.0" encoding="utf-8"?>    <DirectionalLayout        xmlns:ohos="http://schemas.huawei.com/res/ohos"        xmlns:app="http://schemas.huawei.com/hap/res-auto"        ohos:height="match_parent"        ohos:width="match_parent"        ohos:orientation="vertical"        ohos:background_element="#000000">            <de.hdodenhof.circleimageview.CircleImageView                ohos:id="$+id:tempciv"                ohos:height="290vp"                ohos:width="290vp"                ohos:image_src="$media:profilepic"                ohos:orientation="vertical"                ohos:layout_alignment="center"                ohos:top_padding="10vp"                app:civ_border_width="4vp"                app:civ_color="#000000"                app:civ_bg_color="#FF0000"/>    </DirectionalLayout>

复制代码

你可能已经观察到我们在上面的代码中有 ohos:image_src="$media:profilepic"，这里我们指的是要在 CircleImageView 中显示的图像。图像存储在 Media 文件夹中并被引用，如下所示。

第 7 步：现在我们已经添加了依赖项和布局细节，现在让我们在 Java 文件中添加功能部分。导航到“MainAbilitySlice.java”，如下所示。

第 8 步：将 onStart 功能替换为以下代码，其中我们引用布局为 Layout_ability_main，组件 id 为 Id_tempciv，然后将边框设置为 CircleImage。

@Override public void onStart(Intent intent){    super.onStart(intent);    super.setUIContent(ResourceTable.Layout_ability_main);    CircleImageView civ;    civ = (CircleImageView)findComponentById(        ResourceTable.Id_tempciv);    civ.setBorderColor(Color.BLACK);}

复制代码

第 9 步：就是这样，我们添加了依赖项，创建了布局文件，然后是调用 onStart 的 java 文件和保存图像的媒体文件。现在我们可以通过选择“Build” -> Rebuild Project 来重建项目

第 10 步：构建成功后，你可以在本地远程模拟器上运行应用程序。为了访问模拟器，你需要注册你的 id 并完成验证。接下来导航到“工具”->“设备管理器”，系统将提示你登录并授予访问权限，完成后你将显示一个包含模拟器列表的对话框，如下所示，你可以通过单击播放来选择模拟器每个模拟器上的按钮，你可以激活它。

第 11 步：如果模拟器正在运行，那么你应该看到如下屏幕所示。

第 12 步：你几乎可以使用 HarmonyOS 中内置的 CircleImageView 库启动你的第一个应用程序，现在模拟器已启动，单击“运行”绿色播放按钮，这将显示 CircleImageView，如下所示。

你已经成功地使用 CircleImageView 库构建了你的第一个 HarmonyOS 应用程序，你可以在此处找到包含该库的完整代码。在“ circleimageview ”文件夹下可以找到库代码，在“ entry ”下可以找到应用程序代码。现在是自定义 CircleImageView 的时候了。下面是该库支持的 XML 属性列表。

civ_color – 指定边框颜色。
civ_border_width – 指定边框宽度。
civ_bg_color – 指定背景颜色

应用程序开发人员的公共 API 列表

Setter 方法

Getter 方法

让我们自定义边框相关的属性

在此自定义中，我们最初将边框颜色设置为黑色，然后单击按钮将边框颜色更改为蓝色，如下所示。

Layout.xml:<de.hdodenhof.circleimageview.CircleImageView    ohos:id="$+id:tempciv"    ohos:height="290vp"    ohos:width="290vp"    ohos:image_src="$media:profilepic"    ohos:orientation="vertical"    ohos:layout_alignment="center"    ohos:top_padding="10vp"    app:civ_border_width="4vp"    app:civ_color="#000000"    app:civ_bg_color="#FF0000"/>

复制代码

CircleImageView civ;civ = (CircleImageView)findComponentById(ResourceTable.Id_tempciv);civ.setBorderColor(Color.BLUE);civ.setBorderWidth(20);

复制代码

在此示例中，我们在运行时更改图像在这里，我们在媒体文件夹中存储了两个不同的图像，单击按钮时，我们更改图像，如下所示。

<de.hdodenhof.circleimageview.CircleImageView    ohos:id="$+id:tempciv"    ohos:height="290vp"    ohos:width="290vp"    ohos:image_src="$media:profilepic"    ohos:orientation="vertical"    ohos:layout_alignment="center"    ohos:top_padding="10vp"    app:civ_border_width="4vp"    app:civ_color="#000000"    app:civ_bg_color="#FF0000"/>

复制代码

CircleImageView civ;civ = (CircleImageView)findComponentById(ResourceTable.Id_tempciv);civ.setPixelMap(ResourceTable.Media_Desert);

复制代码

发布于: 刚刚阅读数: 3

原文链接:【http://xie.infoq.cn/article/5419031423f6d98c105d5749a】。

海拥(haiyong.site)

关注

公众号：海拥 2021.11.29 加入

【个人网站】haiyong.site 【联系方式】微信：wh18363 【软件技能】前端，Java，Python 【个人称号】InfoQ 写作社区签约作者，华为云享专家，CSDN原力作者，全栈领域优质创作者，掘金2021年度人气作者No.21

发布

暂无评论

创作场景

在 HarmonyOS 中实现 CircleImageView 库

海拥(haiyong.site)

评论