Cómo agregar un cuadro de diálogo "Calificar mi aplicación" a una aplicación de Android usando la biblioteca de Android Five Stars

Cómo agregar un cuadro de diálogo "Calificar mi aplicación" a una aplicación de Android usando la biblioteca de Android Five Stars

Como desarrolladores, nos encanta conocer la opinión de los usuarios sobre nuestras creaciones. Por lo general, un usuario no compartirá su opinión públicamente debido al tiempo, la pereza, etc., sin embargo, esto es importante para nosotros, por lo que si no califican su aplicación en Play Store, al menos deberían calificar la aplicación internamente, donde usted De alguna manera puede saber lo que piensa el usuario sobre su aplicación. Si está buscando algún tipo de diálogo que le permita al usuario dar algunas estrellas a sus aplicaciones, ¡entonces ha encontrado la publicación correcta!

En este artículo, le mostraremos cómo instalar e implementar la biblioteca Android Five Stars en su aplicación de Android.

1. Instale la biblioteca de Android Five Stars

Android Five Stars Library es una pequeña biblioteca que ayuda a los desarrolladores a agregar un cuadro de diálogo "Calificar mi aplicación" a sus aplicaciones. Se llama "Cinco estrellas" porque el diálogo tiene un comportamiento diferente según la calificación otorgada por el usuario. La biblioteca requiere que tenga el valor  minSdkVersion en 15 en su archivo build.gradle. Modifica tu archivo build.gradley agrega la nueva biblioteca:

dependencies {
    implementation 'com.github.Angtrim:Android-Five-Stars-Library:v3.1'
}

Después de actualizar el archivo, sincronice su proyecto de Android. Para obtener más información sobre esta biblioteca, visite el repositorio oficial en Github aquí .

2. Implementación

Después de la instalación, la implementación de la biblioteca en su aplicación será bastante fácil. Como primer paso, incluya los espacios de nombres requeridos en la clase donde ejecutará el diálogo:

// Para mostrar un mensaje en el registro (logcat)
import android.util.Log;

// Espacios de nombres de la aplicación
import angtrim.com.fivestarslibrary.FiveStarsDialog;
import angtrim.com.fivestarslibrary.NegativeReviewListener;
import angtrim.com.fivestarslibrary.ReviewListener;

Luego, procede a mostrar el cuadro de diálogo con el siguiente fragmento:

// En este ejemplo, ejecutamos el cuadro de diálogo cada vez que se inicia la aplicación.
FiveStarsDialog fiveStarsDialog = new FiveStarsDialog(this, "dev@ourcodeworld.com");
fiveStarsDialog.setRateText("Tu texto personalizado")
    .setTitle("Your custom title")
     // Si el "Modo Forzado" está activado, cuando el usuario selecciona 4/5 estrellas
     // se le redirige inmediatamente a Play Store, sin pedir confirmación
    .setForceMode(false)
    // Mercado abierto si se selecciona una calificación> = 2
    .setUpperBound(2)
    // ANULAR la intención del correo para una revisión negativa
    .setNegativeReviewListener(this)
    // Se usa para escuchar reseñas (si desea rastrearlas)
    .setReviewListener(this)
     // Mostrar después define cuántas veces después de la ejecución de este fragmento
     // debería aparecer el diálogo (0 == inmediatamente)
    .showAfter(0);

Tenga en cuenta que la clase que contiene el código necesita implementar las clases NegativeReviewListener y ReviewListener para poder usar esto como contexto de los métodos setNegativeReviewListenersetReviewListener, por ejemplo:

public class MainActivity extends AppCompatActivity implements NegativeReviewListener, ReviewListener { ... }

De lo contrario, deberá pasar una nueva instancia de una clase que implemente las clases mencionadas y contenga los 2 métodos que funcionan como devolución de llamada para el diálogo de acuerdo con la selección del usuario:

@Override
public void onNegativeReview(int stars) {
    Log.d(TAG, "Negative review " + stars);
}

@Override
public void onReview(int stars) {
    Log.d(TAG, "Review " + stars);
}

Ahora, cada vez que se ejecute el fragmento, evaluará si debe mostrarse de acuerdo con el valor proporcionado en el showAftermétodo. La biblioteca es muy simple, solo tenga en cuenta que:

  • Cuando el usuario toca Aceptar o NUNCA, el cuadro de diálogo no se volverá a mostrar
  • Cuando el usuario toque NO AHORA, el contador de acceso se reiniciará y el cuadro de diálogo se mostrará nuevamente después de los tiempos seleccionados.
  • Si el usuario otorga  4 o 5 estrellas de 5 , se envía al usuario a la página de Google Play Store para otorgar una calificación real.
  • Si el usuario da  3 o menos estrellas de 5 , se le pide al usuario que  envíe un informe de error  al desarrollador.

Ejemplo completo

La siguiente clase proporciona un ejemplo completo de una aplicación de trabajo que usa la biblioteca:

package com.yourcompany.yourapp;

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;

import android.util.Log;
import angtrim.com.fivestarslibrary.FiveStarsDialog;
import angtrim.com.fivestarslibrary.NegativeReviewListener;
import angtrim.com.fivestarslibrary.ReviewListener;


public class MainActivity extends AppCompatActivity implements NegativeReviewListener, ReviewListener {

    private static final String TAG = MainActivity.class.getSimpleName();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);


        // In this example, we are running the dialog everytime the app starts
        FiveStarsDialog fiveStarsDialog = new FiveStarsDialog(this,"dev@ourcodeworld.com");
        fiveStarsDialog.setRateText("Your custom text")
            .setTitle("Your custom title")
            .setForceMode(false)
            // Mercado abierto si se selecciona una calificación> = 2
            .setUpperBound(2)
            // ANULAR la intención del correo para una revisión negativa
            .setNegativeReviewListener(this)
            // Se usa para escuchar reseñas (si desea rastrearlas)
            .setReviewListener(this)
            // Mostrar después define cuántas veces después de la ejecución de este fragmento
            // si aparece el diálogo (0 == inmediatamente)
            .showAfter(0);
    }

    @Override
    public void onNegativeReview(int stars) {
        Log.d(TAG, "Revisión negativa " + stars);
    }

    @Override
    public void onReview(int stars) {
        Log.d(TAG, "revisión " + stars);
    }
}

La biblioteca de Android Five Stars utiliza internamente la clase SharedPreferences de Android para almacenar la cantidad de veces que se ejecuta el fragmento para mostrar el cuadro de diálogo (método showAfter).

Que te diviertas ❤️!

Esto podria interesarte

Conviertete en un programador más sociable