Android Iconics
v5.4.0
... يسمح بتضمين أي خط رمز بكل أيقوناته المتجهة في مشروعك. لا حدود. مقياس بلا حدود ، استخدم أي لون في أي وقت، قم بتوفير محيط ، والعديد من التخصيصات الإضافية...
ما الذي تم تضمينه • الإعداد • دليل الترحيل؟ • WIKI / الأسئلة الشائعة • الخط المخصص ⁉️ • نموذج التطبيق
الخطوط المتاحة بالفعل
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 } " ملحوظة
تتطلب الخطوط التي تنتهي بـ -kotlin الإصدار 4.x على الأقل من Android-Iconics v5.1.x أو يتطلب الإصدار الأحدث أحدث إصدارات الخطوط
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 ' ملحوظة
بالنسبة لمستخدمي كتالوج الإصدارات، لا يمكن إضافة النوع، ولكن يمكنك القيام بذلك من خلال تعريف التنفيذ. implementation(libs.material.typeface) { artifact { type = "aar" } }
تحذير
تستخدم الخطوط مكتبة jetpack startup لتسجيل نفسها تلقائيًا. إذا تم تعطيل jetpack startup ، فيجب تسجيل الخطوط يدويًا. يرجى العثور على تفاصيل إضافية في تسجيل الخطوط.
ملحوظة
قد يكون مطلوبًا استدعاء Iconics.init(applicationContext) إذا لم يتم استخدام واجهات برمجة التطبيقات المستندة إلى السياق من المكتبة.
IconicsDrawable ( this , FontAwesome . Icon .faw_android). apply {
colorInt = Color . RED
sizeDp = 24
} إذا كنت تستخدم مكتبة Iconics عبر XML، فقم بتوفير الرمز الذي تريد استخدامه في بناء الجملة التالي: gmd-favorite --> fontId - iconName . يمكن العثور على قائمة بالخطوط المتاحة ومعرف fontId الخاص بها هنا. يمكن العثور على جميع أسماء الأيقونات من الخطوط الافتراضية عبر تطبيق DEMO.
استخدم بناء الجملة { 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.android.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 " />لتضمين دعم الإنشاء التجريبي في مشروعك، أضف التبعية التالية إلى مشروعك (منذ الإصدار 5.2.0)
implementation " com.mikepenz:iconics-compose: ${ latestAndroidIconicsRelease } " استخدم غلاف Image المقدم وقم بتعيين الرمز.
Image (
GoogleMaterial . Icon .gmd_access_alarm,
colorFilter = ColorFilter .tint( MaterialTheme .colors.primary),
)| وصلة | بادئة | التبعية |
|---|---|---|
| أيقونات تصميم المواد من Google ** الأصل بواسطة | ||
| جوجل** | جمد، جمو، جمر، جمس | التنفيذ "com.mikepenz:google-material-typeface{-outlined,rounded,sharp}:+@aar" |
| الخط الأيقوني لتصميم المواد ** مادة Google | ||
| مبدع** | com.gmi | التنفيذ "com.mikepenz:material-design-iconic-typeface:+@aar" |
| فونتاويسوم | فاو | التنفيذ "com.mikepenz:fontawesome-typeface:+@aar" |
| FontawesomeBrand | رائع | التنفيذ "com.mikepenz:fontawesome-typeface:+@aar" |
| FontawesomeRegular | بعيد | التنفيذ "com.mikepenz:fontawesome-typeface:+@aar" |
| الأرصاد الجوية | التقى | التنفيذ "com.mikepenz:meteocons-typeface:+@aar" |
| ثمانيات | أكتوبر | التنفيذ "com.mikepenz:octicons-typeface:+@aar" |
| مواد المجتمع | كمد | التنفيذ "com.mikepenz:community-material-typeface:+@aar" |
| أيقونات الطقس | wic | التنفيذ "com.mikepenz: Weather-icons-typeface:+@aar" |
| أيقونات الكتابة | اكتب | التنفيذ "com.mikepenz:typeicons-typeface:+@aar" |
| إنتيبو | الأنف والحنجرة | التنفيذ "com.mikepenz:entypo-typeface:+@aar" |
| ديفيكون | ديف | التنفيذ "com.mikepenz:devicon-typeface:+@aar" |
| أيقونات التأسيس | fo | التنفيذ "com.mikepenz:foundation-icons-typeface:+@aar" |
| الأيونيكونات | أيون | التنفيذ "com.mikepenz:ionicons-typeface:+@aar" |
| بيكسدن7السكتة الدماغية | pe7 | التنفيذ "com.mikepenz:pixeden-7-stroke-typeface:+@aar" |
| تصميم المواد دي إكس | cmf | التنفيذ "com.mikepenz:material-design-icons-dx-typeface:+@aar" |
| أيقونات الفوسفور | pho | التنفيذ "com.mikepenz: phosphor-typeface:+@aar" |
| أيقونات بسيطة | سيم | التنفيذ "com.mikepenz:simple-icons-typeface:+@aar" |
يتم ربط التراخيص الخاصة بجميع الخطوط المضمنة داخل الفصل الدراسي أو يمكن العثور عليها في المستودعات المقابلة.
يقدم Appcompat v1.4.x دعم الرموز التعبيرية الممكّن افتراضيًا في جميع طرق عرض AppCompat* ، مما يمنع طرق العرض IconicsView* (وحدة طرق عرض الأيقونات) من تطبيق النمط القابل للتوسيع بشكل صحيح. لإصلاح هذه المشكلة، يجب تعطيل دعم الرموز التعبيرية عن طريق القيام بما يلي:
app:emojiCompatEnabled="false"مزيد من المعلومات حول دعم الرموز التعبيرية appcompat: https://developer.android.com/jetpack/androidx/releases/appcompat#1.4.0-alpha01
إذا كنت تريد إضافة الخط المخصص الخاص بك، أو GenericFont، فيجب عليك تسجيل هذا الخط (قبل استخدامه). أفضل مكان للقيام بذلك هو 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 ())
}
}كل شيء سهل وبسيط. يمين؟ ولكن الآن لديك رمز واحد في عرض النص الخاص بك وتحتاج إلى تصميم إضافي؟ ما عليك سوى تحديد النمط لجميع الرموز أو رمز محدد فقط. يمكنك العثور على هذا في PlaygroundActivity للعينة أيضًا.
Iconics . Builder ()
.style( ForegroundColorSpan ( Color . WHITE ), BackgroundColorSpan ( Color . BLACK ), RelativeSizeSpan ( 2f ))
.styleFor( FontAwesome . Icon .faw_adjust, BackgroundColorSpan ( Color . RED ))
.on(tv1)
.build()في بعض الأحيان، قد لا ترغب في استخدام مفتاح الرمز ("faw-adjust") مثل هذا، ولكن استخدم التعداد الذي يوفره خط معين. وكلاهما صالح:
IconicsDrawable ( this , " faw-adjust " ).actionBar() IconicsDrawable ( this , FontAwesome . Icon .faw_adjust). apply {
sizeDp = 24
paddingDp = 1
}يكون هذا ممكنًا باستخدام ملف التعيين *.ttf و*.css فقط. وسوف يأخذك دقيقتين.
يمكنك الحصول على هذين الملفين عن طريق تنزيل خط رمز الويب، أو إذا كنت تريد إنشاء خط رمز مخصص خاص بك من ملفات *.svg، فيمكنك استخدام الأدوات التالية:
بعد حصولك على هذين الملفين، توجه إلى أداة إنشاء الأيقونات الإضافية android-iconics.mikepenz.com. أدخل كافة المعلومات. أضف *.ttf و*.css وانقر على الزر. سيتم إنشاء وتنزيل ملحق خط الأيقونة بصيغة zip. (هذه الأداة محلية فقط، ولا يتم إرسال أي ملفات إلى الخادم، ويمكنك استخدامها بأمان مع أي أيقونات)
لإنشاء حقل سلسلة لكل رمز من أيقونات الخط الخاص بك، يمكنك استخدام هذا المولد البسيط: Android-Iconics String Generator
مكون إضافي رائع يمكنه جلب الخط تلقائيًا من Fontastic وإنشاء وحدة Android لمشروعك. أيقونات الخط مولد
يتم تجميع قواعد ProGuard / R8 داخليًا مع كل خط.
ContextWrapper المخصص داخل الخطمايك بينز
بيتر جولكو
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.apache.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.
