Download Napier - download do código-fonte Napier

Napier

Outro código-fonte

2.7.1

Baixar

logotipo

Napier é uma biblioteca de loggers para Kotlin Multiplatform.
Suporta Android, Darwin (iOS, macOS, watchOS, tvOS), JVM, JavaScript.
Os logs escritos no módulo comum são exibidos no visualizador de logs de cada plataforma.

Visualização

Android

formato: [Class name]$[Method name]: [Your log]

usa o android.util.Log (Logcat)

visualização-android

Darwin(iOS, macOS, watchOS, tvOS)[silício Intel/Apple]

formato: [Date time][Symbol][Log level][Class name].[Method name] - [Your log]

Adicionado rótulo [async] no final, se for chamado a partir de funções de suspensão.

usa a print

visualização-ios

JavaScript

usa o console.log

visualização-js

JVM

usa o java.util.logging.Logger

visualização-jvm

código de amostra comum

 class Sample {

    fun hello (): String {
        Napier .v( " Hello napier " )
        Napier .d( " optional tag " , tag = " your tag " )

        return " Hello Napier "
    }

    suspend fun suspendHello (): String {
        Napier .i( " Hello " )

        delay( 3000L )

        Napier .w( " Napier! " )

        return " Suspend Hello Napier "
    }

    fun handleError () {
        try {
            throw Exception ( " throw error " )
        } catch (e : Exception ) {
            Napier .e( " Napier Error " , e)
        }
    }
}

Download

Repositório

Você pode baixar esta biblioteca do repositório MavenCentral ou jCenter.

Central de Maven

Você pode fazer o download em 1.4.1 .
O nome do pacote é io.github.aakira

repositories {
    mavenCentral()
}

jCenter

Você pode fazer o download até 1.4.1 .
O nome do pacote é com.github.aakira

repositories {
    jCenter()
}

Versão

Defina o nome da versão em seu build.gradle

def napierVersion = "[latest version]"

Comum

Adicione a dependência às suas dependências commonMain

descolado

sourceSets {
    commonMain {
        dependencies {
            // ...
            implementation " io.github.aakira:napier: $n apierVersion "
        }
    }
}

nós

sourceSets {
    val commonMain by getting {
        dependencies {
            implementation( " io.github.aakira:napier: $napierVersion " )
        }
    }
}

Uso

Como usar

Módulo comum

 // verbose log
Napier .v( " Hello napier " )
Napier .v { " Hello napier " }

// you can set a tag for each log
Napier .d( " optional tag " , tag = " your tag " )
Napier .d(tag = " your tag " ) { " optional tag " }

try {
    .. .
} catch (e : Exception ) {
    // you can set the throwable
    Napier .e( " Napier Error " , e)
    Napier .e(e) { " Napier Error " }
}

// you can also use top-level function
log { " top-level " }
log(tag = " your tag " ) { " top-level " }

Inicializar

Você deve inicializar o Napier em seu módulo.

Android

 Napier .base( DebugAntilog ())

iOS

Escreva o código de inicialização em seu projeto kotlin mpp.

 fun debugBuild () {
    Napier .base( DebugAntilog ())
}

Chame o código de inicialização do projeto iOS.

 NapierProxyKt . debugBuild ( )

Limpar antilogaritmo

 Napier .takeLogarithm()

Nível de registro

Plataforma	Amostra
VERBOSO	Napier.v()
DEPURAR	Napier.d()
INFORMAÇÕES	Napier.i()
AVISO	Napier.w()
ERRO	Napier.e()
AFIRMAR	Napier.wtf()

Executar thread em segundo plano

Você pode usar esta biblioteca no thread de segundo plano no iOS usando Kotlin.coroutines como nativo-mt.

Definir escopo

 internal val mainScope = SharedScope ( Dispatchers . Main )

internal val backgroundScope = SharedScope ( Dispatchers . Default )

internal class SharedScope ( private val context : CoroutineContext ) : CoroutineScope {
    private val job = Job ()
    private val exceptionHandler = CoroutineExceptionHandler { _, throwable ->
        println ( " [Coroutine Exception] $throwable " )
    }

    override val coroutineContext : CoroutineContext
        get() = context + job + exceptionHandler
}

Uso

backgroundScope.launch {
    suspendFunction()
}

Avanço

Você pode injetar Antilog personalizado.
Portanto, você deve alterar os Antilogs na compilação de depuração ou na compilação de lançamento.

Crashlytics

Amostras do Crashlytics AntiLog

Projetos de amostra usam o Firebase Crashlytics.
Você deve definir os arquivos de autenticação para android/google-services.json e ios/Napier/GoogleService-Info.plist .

Verifique o documento do Firebase. [Android, iOS]

Android

Escreva isso na sua classe de aplicação.

 if ( BuildConfig . DEBUG ) {
    // Debug build

    // disable firebase crashlytics
    FirebaseCrashlytics .getInstance().setCrashlyticsCollectionEnabled( false )
    // init napier
    Napier .base( DebugAntilog ())
} else {
    // Others(Release build)

    // enable firebase crashlytics
    FirebaseCrashlytics .getInstance().setCrashlyticsCollectionEnabled( true )
    // init napier
    Napier .base( CrashlyticsAntilog ( this ))
}

iOS

Escreva isso em seu AppDelegate.

 #if DEBUG
// Debug build

// init napier
NapierProxyKt . debugBuild ( )

#else
// Others(Release build)

// init firebase crashlytics
FirebaseApp . configure ( )

// init napier
NapierProxyKt . releaseBuild ( antilog : CrashlyticsAntilog (
    crashlyticsAddLog : { priority , tag , message in
        Crashlytics . crashlytics ( ) . log ( " ( String ( describing : tag ) ) : ( String ( describing : message ) ) " )
} ,
    crashlyticsSendLog : { throwable in
        Crashlytics . crashlytics ( ) . record ( error : throwable )
} ) )
#endif

Licença

 Copyright (C) 2019 A.Akira

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

https://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.