Android Iconics

...允许在您的项目中包含任何具有其所有向量图标的图标字体。没有限制。毫无局限的比例，随时使用任何颜色，提供轮廓和许多其他自定义...

包括的内容•设置•迁移指南?•Wiki / FAQ•自定义字体?️•示例应用程序

• 没有自定义限制（尺寸，颜色，轮廓，背景，填充，定位，...）
• 阴影支持
• 用作XML绘制的启动API 24
• 一个图标来源（不再有MDPI，HDPI，...）
• 灵活性
  • 尺寸
  • 颜色
  • 轮廓
  • 阴影
  • RTL的自动镜像（选择加入）
• 如果需要绘制，它也将与IconicsDrawable一起使用！
• 节省APK尺寸
• 组成支持

已经可用的字体

• Google材料设计图标
• 材料设计标志性字体
• fontawesome
• meteocon
• 八孔
• 社区材料
• 天气图标
• 类型
• Entypo
• 德文
• 基础图标
• 离子
• 材料设计DX
• Pixeden 7中风
• 磷
• 简单图标
• 或使用所需的任何图标创建自己的字体。

• Kotlin | v5.4.0
• 预释放| v5.5.0-b01

 dependencies {
    // the core iconics library (without any widgets)
    implementation " com.mikepenz:iconics-core: ${ latestAndroidIconicsRelease } "
    implementation " androidx.appcompat:appcompat: ${ versions.appCompat } "
}

 // this adds all ui view widgets (IconicsButton, IconicsImageView, ...)
implementation " com.mikepenz:iconics-views: ${ latestAndroidIconicsRelease } " 

implementation ' com.mikepenz:google-material-typeface:4.0.0.3-kotlin@aar '
implementation ' com.mikepenz:google-material-typeface-{outlined|rounded|sharp}:4.0.0.2-kotlin@aar '
implementation ' com.mikepenz:material-design-iconic-typeface:2.2.0.9-kotlin@aar '
implementation ' com.mikepenz:fontawesome-typeface:5.9.0.3-kotlin@aar '
implementation ' com.mikepenz:octicons-typeface:11.1.0.1-kotlin@aar '
implementation ' com.mikepenz:meteocons-typeface:1.1.0.8-kotlin@aar '
implementation ' com.mikepenz:community-material-typeface:7.0.96.1-kotlin@aar ' // note 5.3.45.1 and newer alphabetically sorts, and merges in 3 sections
implementation ' com.mikepenz:weather-icons-typeface:2.0.10.8-kotlin@aar '
implementation ' com.mikepenz:typeicons-typeface:2.0.7.8-kotlin@aar '
implementation ' com.mikepenz:entypo-typeface:1.0.0.8-kotlin@aar '
implementation ' com.mikepenz:devicon-typeface:2.0.0.8-kotlin@aar '
implementation ' com.mikepenz:foundation-icons-typeface:3.0.0.8-kotlin@aar '
implementation ' com.mikepenz:ionicons-typeface:2.0.1.8-kotlin@aar '
implementation ' com.mikepenz:pixeden-7-stroke-typeface:1.2.0.6-kotlin@aar '
implementation ' com.mikepenz:material-design-icons-dx-typeface:5.0.1.3-kotlin@aar '
implementation ' com.mikepenz:phosphor-typeface:1.0.0.1-kotlin@aar '
implementation ' com.mikepenz:simple-icons-typeface:17.0.0.3@aar ' 

 IconicsDrawable ( this , FontAwesome . Icon .faw_android). apply {
    colorInt = Color . RED
    sizeDp = 24
}

如果您通过XML使用ICONICS库，则提供您要在以下语法中使用的图标： gmd-favorite > fontId iconName 。可以在此处找到可用字体及其fontId的列表。默认字体中的所有图标名称均可通过演示应用程序找到。

使用{ Icon-Definer }语法

 Some great text with a {faw-android} font awesome icon and {met-wind} meteocons icons.

在drawable文件夹中指定可绘制的内容。

< com .mikepenz.iconics.IconicsDrawable
    xmlns : app = " http://schemas.an*dr**oid.com/apk/res-auto "
    app : ico_icon = " gmd_favorite "
    app : ico_color = " #0000FF "
    app : ico_contour_width = " 1dp "
    app : ico_contour_color = " #00FFFF "
    app : ico_size = " 24dp " />
    // all custom theming attributes supported

像应用程序中的任何普通绘制一样使用。此功能由@dzamlo提出并最初提供

< com .mikepenz.iconics.view.IconicsImageView
    android : layout_width = " 72dp "
    android : layout_height = " 72dp "
    app : iiv_color = " @android:color/holo_red_dark "
    app : iiv_icon = " gmd-favorite " />  // or @string/gmd_favorite with our generator
    //app:iiv_size="12dp"
    //app:iiv_padding="2dp"
    //app:iiv_contour_color="#FF0000"
    //app:iiv_contour_width="2dp"
    //app:iiv_background_color="#FFFF00"
    //app:iiv_corner_radius="2dp"
    //app:iiv_background_contour_color="#FF0000"
    //app:iiv_background_contour_width="1dp"
    //app:iiv_shadow_radius="4dp"
    //app:iiv_shadow_dx="1dp"
    //app:iiv_shadow_dy="1dp"
    //app:iiv_animations="spin|blink_alpha|blink_scale"

< com .mikepenz.iconics.view.IconicsTextView
    android : text = " abc{hif-test}defgh{faw-adjust}ijk{fon-test1}lmnopqrstuv{fon-test2}wxyz "
    android : textColor = " @android:color/black "
    android : layout_width = " wrap_content "
    android : layout_height = " 56dp "
    android : textSize = " 16sp " />

< com .mikepenz.iconics.view.IconicsButton
    android : text = " {faw-adjust} Button "
    android : layout_width = " 120dp "
    android : layout_height = " 60dp " />

为了在项目中包括实验性组成的支持，将以下依赖性添加到您的项目中（自v5.2.0）

implementation " com.mikepenz:iconics-compose: ${ latestAndroidIconicsRelease } "

使用提供的Image包装器并设置图标。

 Image (
    GoogleMaterial . Icon .gmd_access_alarm,
    colorFilter = ColorFilter .tint( MaterialTheme .colors.primary),
)

所有包含字体的许可证都链接在班级内部，或者可以在coresporting存储库中找到。

AppCompat v1.4.x将默认启用的表情符号支持引入所有AppCompat*视图，该视图阻止了IconicsView* views（Iconics-Views模块）正确应用跨度样式。要解决此问题，必须通过执行以下操作表情符号支持：

app:emojiCompatEnabled="false"

有关AppCompat表情符号支持的更多信息：https：//developer.android.com/jetpack/androidx/releases/appcompat#1.4.0-alpha01

如果要添加自己的自定义字体或通用字体，则必须注册此字体（在使用它之前）。最好的地方是Application 。

并根据您的意愿初始化Iconics

 class CustomApplication : Application () {
    override fun onCreate () {
        super .onCreate()

        // register custom fonts like this (or also provide a font definition file)
        Iconics .registerFont( CustomFont ())
    }
}

一切都很简单。正确的？但是现在您在文本视图中获得了一个图标，并且需要其他样式？只需定义所有图标或仅特定图标的样式即可。您也可以在样本的游乐场活动中找到这一点。

 Iconics . Builder ()
    .style( ForegroundColorSpan ( Color . WHITE ), BackgroundColorSpan ( Color . BLACK ), RelativeSizeSpan ( 2f ))
    .styleFor( FontAwesome . Icon .faw_adjust, BackgroundColorSpan ( Color . RED ))
    .on(tv1)
    .build()

有时，您不喜欢使用像这样的图标键（“ faw-unjust”），而是使用特定字体提供的枚举。两者都是有效的：

 IconicsDrawable ( this , " faw-adjust " ).actionBar()

 IconicsDrawable ( this , FontAwesome . Icon .faw_adjust). apply {
    sizeDp = 24
    paddingDp = 1
}

仅使用 *.ttf和 *.css映射文件，这是可能的。并将带您2分钟。

您可以通过下载Web图标字体获取这两个文件，或者如果要从 *.svg文件创建自己的自定义图标字体，则可以使用以下工具：

• fontello
• Icomoon
• 传说
• 如果您找到其他工具，请让我知道。

收到这两个文件后，请转到图标插件创建工具Android-iconics.mikepenz.com。输入所有信息。添加 *.ttf和 *.css，然后单击按钮。它将生成并下载图标字体插件作为zip。 （此工具仅是本地的，没有将文件发送到服务器，您可以与任何图标安全地使用它）

对于为字体的每个图标生成字符串字段，您可以使用此简单的生成器：Android-Iconics String Generator

一个很棒的Gradle插件，可以自动从字体获取字体，并为您的项目生成Android模块。 Iconics-Font Generator

proguard / r8规则与每种字体内部捆绑在一起。

• Baptiste Lagache感谢Gradle字体模块生成器
• 还要感谢所有其他贡献者。

• 琼·扎帕塔（Joan Zapata）是Android-Iconify的创建者，这给了我这个项目的想法。一些核心概念和想法被重复使用，但一切都是从头开始写的。
• 克里斯托弗·詹金斯ContextWrapper Christopher Jenkins
• 斯蒂芬·舒伯（Stephan Schober）

• 迈克·彭兹（Mike Penz）

  • mikepenz.dev -blog.mikepenz.dev -mikepenz@gmail.com
  • paypal.me/mikepenz
  • 自动变更生成动作

• 彼得·古尔科

  • github.com/ztrap

 Copyright 2021 Mike Penz

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.*a*p*ache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.