android trinity

Android-Trinity

هذا هو إطار عمل صغير مع جزء كبير من رمز السقالات (مع بعض الأدوات المساعدة الرائعة ورمز المصدر المعدة) المطلوب لبدء تطبيق Android جديد.

خلفية ؟

نعم ، قد يقوم Android Studio بإنشاء مشروع لك ، ولكن هناك أجزاء مفقودة ، والتي ينتهي بها الأمر دائمًا إلى إضافتها إلى كل مشروع أقوم بإنشائه. يهدف هذا الإطار الصغير (أود أن أقول لا يزال رمز السقالات) إلى حل هذا من خلال جعل مشروع Android سهلاً وسريعًا لإنشاء مشروع Android مع لبنات البناء الأساسية. تحقق من قسم TODO أدناه لمزيد من المعلومات حول التطور والتقدم.

ماذا يوفر Android-Trinity؟ ؟

حرية. يستخدم أدوات قياسية ولكن منظمًا بطريقة تسهل تطوير Android. يمكنك إعادة تشكيل أو تغيير أي شيء ولكن الفكرة هي أن يكون لديك نقطة انطلاق قوية. تتم جميع الأسلاك من أجلك مع مرونة تعديلها وفقًا لاحتياجاتك.

• Kotlin DSL افتراضيًا في Gradle Build System Leve.
• تقرير رمز analisis الثابت (detekt).
• تقرير تغطية الكود (جاكوكو).
• الفصول الأساسية: BaseActivity و BaseFragments .
• شريط الأدوات مع أنماط محددة مسبقا.
• class اختبار ما قبل النوع: UnitTest ، AndroidTest ، AcceptanceTest .
• نصوص Gradle المسبقة مسبقًا (مجلد buildScr ) تنظمها الجوانب:
  • compilation.gradle.kts
  • infrastructure.gradle.kts
  • quality.gradle.kts
  • variants.gradle.kts
• إدارة التبعيات في مكان واحد: Dependencies.kt
• تسرب الكشف عن التسريبات.
• متغيرات البناء المحددة مسبقًا (تحقق من ملف variants.gradle.kts )
  • أنواع البناء:
    • DEBUG
    • RELEASE
  • نكهات المنتج:
    • DEV
    • INTERNAL
    • PUBLIC
• Kotlin Coroutines
• إطار عمل ميزة مضغوطة

ماذا لا يشمل أندرويد-ثرينيتي؟ (من المحتمل أن يتغير إذا لزم الأمر في الإصدارات المستقبلية)

• دي. يجب عليك اختيار إطار حقن التبعية الخاص بك.
• لا إطار التنقل.
• لا توجد مكتبات LiveData و ViewModel نظرًا لأن بعض المهندسين قد يستخدمون أساليب أخرى على مستوى واجهة المستخدم مثل MVI و MVP ، إلخ.
• لا تدفق كوتلين.
• لا توجد تخطيطات واجهة المستخدم لدعم جهاز الكمبيوتر اللوحي أو Android TV.

مهام Gradle المحددة مسبقًا

• ./gradlew runStaticAnalysis
• ./gradlew runTestCoverage
• ./gradlew runUnitTests
• ./gradlew runAcceptanceTests
• ./gradlew compileApp
• ./gradlew runApp

كيف تستخدمه؟

في الوقت الحالي ، هناك خطوتين يدويتين متضمنتين لأننا في مرحلة مبكرة جدًا. لكننا نؤمن بتطور البرامج الألياف أليس كذلك؟ لذا ترقبوا وتفقد كل من أقسام كيفية المساهمة وقائمة TODO .

• الخطوة 1: انقر فوق لإنشاء ريبو جديد.
• الخطوة 2: استيراد المشروع في Android Studio
• الخطوة 3: إعادة تسمية الحزم وفقًا لاحتياجاتك. com.fernandocejas.sample بشكل افتراضي.

باستخدام مساعدي الاختبار

دعنا نقول أنك تريد كتابة اختبارات (ويجب عليك القيام بها دائمًا ) ، كما ذكرنا ، هناك 3 فئات تلعب دورها وهنا أمثلة على استخدامها:

• UnitTest.kt : فئة قاعدة اختبار الوحدة التي تسخر لك الإعداد (يمكنك فقط استخدام التعليق @Mockk )

 class FeatureFlagTest : UnitTest () {

    @Mockk prival val yourMock

    @Test
    fun `given a feature flag, when it is activated, then executes given logic block` () {
        val activeFlag = ActiveFeatureFlag ()
        val fakeNavigator = mockk< Navigator >(relaxed = true )

        activeFlag whenActivated {
            fakeNavigator.doSomething()
            fakeNavigator.navigateToActiveFeature()
            fakeNavigator.doSomething()
        }

        verify(exactly = 1 ) { fakeNavigator.navigateToActiveFeature() }
        verify(exactly = 2 ) { fakeNavigator.doSomething() }
    }

• AndroidTest.kt : فئة قاعدة اختبار التكامل التي تسخر لك الإعداد (يمكنك فقط استخدام التعليق @Mockk ). يمكنك استخدام هذه الفئات عندما تكون مكونات Android معنية. وهي مدعومة من قبل robolectric.

 class YourTestClass : AndroidTest () {

    @Mockk prival val yourMock

    @Test
    fun `given something, when something happens, then do something` () {
        TODO ()
    }

• AcceptanceTest.kt : فئة قاعدة اختبار واجهة المستخدم التي إعداد الإسبريسو لك

 class MainActivityTest : AcceptanceTest ( MainActivity : :class.java) {

    @Test
    fun checkToolBarTest () {
        onView(withId( R .id.toolbar)).check(matches(isDisplayed()))
    }
}

ميزة أعلام

يتضمن Android-Trinity إطارًا بسيطًا لعلامات الميزات في وضع عدم الاتصال مع واجهة برمجة تطبيقات بسيطة للغاية تم إنشاؤها في وقت الترجمة. إذا كنت تريد المزيد من المعلومات ، راجع طلب السحب المقدم. (تودو: أضف المزيد من الوثائق)

مثال على استخدامه:

 Flag . Hello whenActivated { displayGreeting( R .string.hello) }

تقارير الجودة: تحليل ثابت

• الأداة المختارة هنا هي Detekt بسبب طبيعتها لكوتلين.
• يمكن العثور على مهمة Gradlew وتكوينها داخل ملف quality.gradle.kts .
• قواعد التكوين ccon في التكوين/detekt/detekt.yml.

تقارير الجودة: تغطية الرمز

• الأداة المختارة هنا هي جاكوكو بسبب طبيعتها وشعبيتها في المجتمع.
• يمكن العثور على مهمة Gradlew وتكوينها داخل ملف quality.gradle.kts .

قائمة TODO

• مهام Gradle للنشر على Google Play: App Bundles.
• أتمتة العملية من كيفية استخدام القسم: IDEA: ./gradlew setupProject
• أعلام الميزة المحلية.
• أعد تسمية الحزم الافتراضية إلى io.android-trinity أو io.android.trinity .
• ؟؟؟
• ؟؟؟

كيفية المساهمة

لم يتم تعيين أي شيء في الحجر هنا ويمكن للأشياء أن تتغير وتتطور بناءً على عمل المجتمع والمتطلبات. لذلك إذا كنت ترغب في المساهمة ، فلا تتردد في فتح مشكلة وتسميةها بشكل صحيح: الأخطاء ، والتحسين ، وما إلى ذلك .. أو إرسال العلاقات العامة. يرجى كلاهما مع وصف جيد للنية ، من أجل تسهيل المراجعة

رخصة

 Copyright 2021 Fernando Cejas

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.