Descarga Napier - Descarga del código fuente Napier

Napier

Otro código fuente

2.7.1

Descargar

logo

Napier es una biblioteca de registradores para Kotlin Multiplatform.
Es compatible con Android, Darwin (iOS, macOS, watchOS, tvOS), JVM y JavaScript.
Los registros escritos en el módulo común se muestran en el visor de registradores de cada plataforma.

Avance

Androide

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

utiliza android.util.Log (Logcat)

vista previa-android

Darwin(iOS, macOS, watchOS, tvOS)[Intel/Apple silicio]

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

Se agregó la etiqueta [async] al final, si se llama desde funciones de suspensión.

usa la print

vista previa-ios

javascript

utiliza el console.log

vista previa-js

JVM

utiliza java.util.logging.Logger

vista previa-jvm

código de muestra común

 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)
        }
    }
}

Descargar

Repositorio

Puede descargar esta biblioteca desde el repositorio MavenCentral o jCenter.

centro maven

Puedes descargarlo desde 1.4.1 .
El nombre del paquete es io.github.aakira

repositories {
    mavenCentral()
}

jCentro

Puedes descargarlo hasta 1.4.1 .
El nombre del paquete es com.github.aakira

repositories {
    jCenter()
}

Versión

Establece el nombre de la versión en tu build.gradle

def napierVersion = "[latest version]"

Común

Agregue la dependencia a sus dependencias principales comunes

maravilloso

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

nudos

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

Uso

como usar

módulo común

 // 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

Debe inicializar Napier en su módulo.

Androide

 Napier .base( DebugAntilog ())

iOS

Escriba el código de inicialización en su proyecto kotlin mpp.

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

Llame al código de inicialización desde el proyecto ios.

 NapierProxyKt . debugBuild ( )

Borrar antilogaritmo

 Napier .takeLogarithm()

Nivel de registro

Plataforma	Muestra
VERBOSO	Napier.v()
DEPURAR	Napier.d()
INFORMACIÓN	Napier.i()
ADVERTENCIA	Napier.w()
ERROR	Napier.e()
AFIRMAR	Napier.wtf()

Ejecutar hilo en segundo plano

Puede usar esta biblioteca en el hilo de fondo en iOS usando Kotlin.coroutines como nativo-mt.

Definir alcance

 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()
}

Adelanto

Puede inyectar Antilog personalizado.
Por lo tanto, debe cambiar Antilogs en la versión de depuración o en la versión de lanzamiento.

Crashlíticos

Ejemplos de Crashlytics AntiLog

Los proyectos de muestra utilizan Firebase Crashlytics.
Debe configurar los archivos de autenticación en android/google-services.json y ios/Napier/GoogleService-Info.plist .

Consulte el documento de Firebase. [Android, iOS]

Androide

Escriba esto en su clase de aplicación.

 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

Escribe esto en tu 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

Licencia

 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.