android trinity

안드로이드-트리니티

이것은 새로운 안드로이드 애플리케이션을 시작하는 데 필요한 많은 스캐 폴딩 코드 (일부 좋은 유틸리티 및 준비된 소스 코드 포함)를 갖춘 작은 프레임 워크입니다.

배경?

그렇습니다. Android Studio는 프로젝트를 만들 수 있지만 누락 된 부품이 있습니다. 결국 내가 만든 모든 단일 프로젝트에 추가됩니다. 이 작은 프레임 워크 (여전히 스캐 폴딩 코드라고 말하는 것은 기본 빌딩 블록으로 안드로이드 프로젝트를 쉽고 빠르게 만들어서이를 해결하는 것을 목표로합니다. 진화 및 진행에 대한 자세한 내용은 아래의 TODO 섹션을 확인하십시오.

Android-Trinity는 무엇을 제공합니까? ?

자유. 표준 도구를 사용하지만 안드로이드 개발을 용이하게하는 방식으로 구성됩니다. 리팩터를 리팩터링하거나 변경할 수는 있지만 아이디어는 강력한 출발점을 갖는 것입니다. 모든 배선은 귀하의 요구에 따라 수정되는 유연성으로 귀하를 위해 수행됩니다.

• Kotlin DSL Gradle 빌드 시스템 제출에서 기본적으로.
• 정적 Analisis 코드 보고서 (Detekt).
• 코드 적용 범위 보고서 (Jacoco).
• 기본 클래스 : BaseActivity 및 BaseFragments .
• 스타일이 사전 정의 된 툴바.
• 사전 세트 테스트 클래제 : UnitTest , AndroidTest , AcceptanceTest .
• 측면별로 구성된 사전 컴파일 된 Gradle 스크립트 ( buildScr 폴더) :
  • compilation.gradle.kts
  • infrastructure.gradle.kts
  • quality.gradle.kts
  • variants.gradle.kts
• 한 곳의 종속성 관리 : Dependencies.kt
• 누출 감지를위한 누출.
• 사전 정의 된 빌드 변형 (Check variants.gradle.kts 파일)
  • 빌드 유형 :
    • DEBUG
    • RELEASE
  • 제품 풍미 :
    • DEV
    • INTERNAL
    • PUBLIC
• 코 틀린 코 루틴
• 컴팩트 한 기능은 프레임 워크를 플래그합니다

Android-Trinity는 무엇을 포함하지 않습니까? (미래 버전에서 필요한 경우 변경 될 가능성)

• DI. 의존성 주입 프레임 워크를 선택해야합니다.
• 내비게이션 프레임 워크가 없습니다.
• 일부 엔지니어는 MVI, MVP 등과 같은 UI 수준에서 다른 접근 방식을 사용할 수 있으므로 LiveData 및 ViewModel 라이브러리가 없습니다.
• 코 틀린 흐름이 없습니다.
• 태블릿 또는 안드로이드 TV 지원을위한 UI 레이아웃이 없습니다.

사전 정의 된 Gradle 작업

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

그것을 사용하는 방법?

당시에는 매우 초기 단계에 있기 때문에 몇 가지 수동 단계가 있습니다. 그러나 우리는 Sofware Evolution을 믿습니까? 따라서 계속 지켜봐 주시고 기여하는 방법 과 목록 섹션을 모두 확인하십시오.

• 1 단계 : 새로운 repo를 만들려면 클릭하십시오.
• 2 단계 : Android Studio에서 프로젝트를 가져옵니다
• 3 단계 : 필요에 따라 패키지 이름을 바꿉니다. com.fernandocejas.sample 기본적으로.

테스트 헬퍼 사용

언급했듯이 테스트를 작성 하고 싶다고 가정 해 봅시다.

• 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 주석 만 사용). 이 클래스가 관련된 안드로이드 구성 요소 일 때 사용할 수 있습니다. Robolectric에 의해 백업됩니다.

 class YourTestClass : AndroidTest () {

    @Mockk prival val yourMock

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

• AcceptanceTest.kt : UI 테스트베이스 클래스 에스프레소를 설정하는 UI 테스트 기본 클래스

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

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

특징 플래그

Android-Trinity에는 컴파일 타임에 생성 된 매우 간단한 API가있는 간단한 오프라인 기능 플래그 프레임 워크가 포함되어 있습니다. 더 많은 정보를 원하시면 소개 된 풀 요청을 참조하십시오. (TODO : 더 많은 문서 추가)

사용의 예 :

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

품질 보고서 : 정적 분석

• 여기서 선택된 도구는 Kotlin의 특성으로 인해 Detekt입니다.
• GradLew 작업과 그 구성은 quality.gradle.kts 내부에서 찾을 수 있습니다.
• cconfiguration 규칙은 config/detekt/detekt.yml에 있습니다.

품질 보고서 : 코드 적용 범위

• 여기서 선택된 도구는 커뮤니티의 본질과 인기로 인해 Jacoco입니다.
• GradLew 작업과 그 구성은 quality.gradle.kts 내부에서 찾을 수 있습니다.

TODO 목록

• Google Play에 게시하기위한 Gradle 작업 : App Bundles.
• 사용 방법 에서 프로세스 자동화 섹션 : Idea : ./gradlew setupProject
• 로컬 기능 깃발.
• 기본 패키지 이름을 io.android-trinity 또는 io.android.trinity 로 바꿉니다.
• ?
• ?

기여하는 방법

여기에 돌에는 아무것도 설정되지 않았으며 커뮤니티 작업과 요구 사항에 따라 상황이 바뀌고 진화 할 수 있습니다. 따라서 기여하고 싶다면 자유롭게 문제를 열고 버그 , 향상 등을 올바르게 레이블을 지정하거나 PR을 보내십시오. 검토를 용이하게하기 위해 의도에 대한 좋은 설명을 가지고 두십시오.

특허

 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.