HamronyOS开发5.0【实现 CircleImageView 库】

你是否希望在 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 方法

setAlpha()	setDisableCircularTransformation()
setBorderColor()	setImageDrawable()
setBorderOverlay()	setImageUri()
setBorderWidth()	setPadding()
setCircleBackgroundColor()	setPaddingRelative()
setColorFilter()	setPixelMap()

Getter 方法

getAlpha()	getColorFilter()
getBorderColor()	isBorderOverlay()
getBorderWidth()	isDisableCircularTransformation()
getCircleBackgroundColor()

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

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

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);

​
最后呢，很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

​​​​

高清完整版请点击→《鸿蒙NEXT星河版开发学习文档》

针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说，我们直接看详细资料鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，帮助大家在技术的道路上更进一步。

《鸿蒙 (OpenHarmony)开发学习视频》

《鸿蒙生态应用开发V2.0白皮书》

《鸿蒙 (OpenHarmony)开发基础到实战手册》

《鸿蒙开发基础》

《鸿蒙开发进阶》

《鸿蒙开发实战》

获取这份鸿蒙星河版学习资料，请点击→《鸿蒙NEXT星河版开发学习文档》

总结

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。

并且鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，未来将会支持 50 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！