Autore Topic: Visualizzare la licenza d'uso ad ogni modifica  (Letto 2491 volte)

Offline xWOLKx

  • Utente junior
  • **
  • Post: 72
  • Adoro quella citazione western!
  • Respect: +7
    • xWOLKx
    • Wolkrasgt
    • Mostra profilo
    • ZondeIT
  • Dispositivo Android:
    Samsung Galaxy Ace
  • Sistema operativo:
    Windows7
Visualizzare la licenza d'uso ad ogni modifica
« il: 31 Gennaio 2012, 00:54:54 CET »
+1
Ho creato questa semplice implementazione per la licenza d'uso, ho preso spunto dal codice di MyTracks (se non erro) e ho aggiunto un controllo sulla versione della APP in modo da rivisualizzare ogni volta che la app si aggiorna.

Ho finito ora, quindi spero di non aver sbagliato niente :P

Attendo impaziente feedback e consigli ^_^


src/[package].Eula.java
Codice (Java): [Seleziona]
/*
 * Copyright (C) 2008 The Android Open Source Project
 *
 * 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.
 */


//package it.zonde.android;

import android.app.Activity;
import android.app.AlertDialog;
import android.content.DialogInterface;
import android.content.SharedPreferences;
import android.content.pm.PackageInfo;
import android.content.pm.PackageManager;
import android.util.Log;

import java.io.IOException;
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.Closeable;

/**
 * Displays an EULA ("End User License Agreement") that the user has to accept before
 * using the application. Your application should call {@link Eula#show(android.app.Activity)}
 * in the onCreate() method of the first activity. If the user accepts the EULA, it will never
 * be shown again. If the user refuses, {@link android.app.Activity#finish()} is invoked
 * on your activity.
 */

class Eula {

    private static final String ASSET_EULA = "EULA";    //Filename of EULA File
    private static final String PREFERENCES_EULA = "eula";    
    private static final String APP_VERSION = "app.version";
    private static final String PREFERENCE_EULA_ACCEPTED = "eula.accepted";        
    protected static PackageInfo pi = null;            
   
   
    public Eula() {
    }
 
    static private void getPackageInfo(final Activity activity) {
        try {
             pi = activity.getPackageManager().getPackageInfo(activity.getPackageName(), PackageManager.GET_ACTIVITIES);
        } catch (PackageManager.NameNotFoundException e) {
            e.printStackTrace();
        }
    }
   
   
    /**
     * callback to let the activity know when the user has accepted the EULA.
     */

    static interface OnEulaAgreedTo {

        /**
         * Called when the user has accepted the eula and the dialog closes.
         */

        void onEulaAgreedTo();
    }

    /**
     * Displays the EULA if necessary. This method should be called from the onCreate()
     * method of your main Activity.
     *
     * @param activity The Activity to finish if the user rejects the EULA.
     * @return Whether the user has agreed already.
     */

    static boolean show(final Activity activity) {
        getPackageInfo(activity);            
        final SharedPreferences preferences = activity.getSharedPreferences(PREFERENCES_EULA, Activity.MODE_PRIVATE);
        if (!preferences.getBoolean(PREFERENCE_EULA_ACCEPTED, false) || (!pi.versionName.equalsIgnoreCase(preferences.getString(APP_VERSION, "")))) {
                final AlertDialog.Builder builder = new AlertDialog.Builder(activity);
                builder.setTitle(activity.getResources().getString(R.string.eula_title)+" v."+pi.versionName);
                builder.setCancelable(true);
                builder.setPositiveButton(R.string.eula_accept, new DialogInterface.OnClickListener() {
                        public void onClick(DialogInterface dialog, int which) {
                                accept(preferences);
                                if (activity instanceof OnEulaAgreedTo) {
                                        ((OnEulaAgreedTo) activity).onEulaAgreedTo();
                                }
                        }
                });
               
                builder.setNegativeButton(R.string.eula_refuse, new DialogInterface.OnClickListener() {
                        public void onClick(DialogInterface dialog, int which) {
                            refuse(preferences, activity);
                        }
                    });
               
                builder.setOnCancelListener(new DialogInterface.OnCancelListener() {
                        public void onCancel(DialogInterface dialog) {
                            refuse(preferences, activity);
                        }
                    });
               
                    builder.setMessage(readEula(activity));
                    builder.create().show();
            return false;
        }
        return true;
    }

    private static void accept(SharedPreferences preferences) {
        preferences.edit().putBoolean(PREFERENCE_EULA_ACCEPTED, true).commit();
        preferences.edit().putString(APP_VERSION, pi.versionName).commit();
    }

    private static void refuse(SharedPreferences preferences, Activity activity) {
        preferences.edit().putBoolean(PREFERENCE_EULA_ACCEPTED, false).commit();
        activity.finish();
    }

    protected static CharSequence readEula(Activity activity) {
        BufferedReader in = null;
        try {
               
                String assetPath = activity.getResources().getString(R.string.subpath);        
            in = new BufferedReader(new InputStreamReader(activity.getAssets().open(assetPath+"/"+ASSET_EULA)));
            String line;
            StringBuilder buffer = new StringBuilder();
            while ((line = in.readLine()) != null) buffer.append(line).append('\n');
            return buffer;
        } catch (IOException e) {
            return "";
        } finally {
            closeStream(in);
        }
    }

    /**
     * Closes the specified stream.
     *
     * @param stream The stream to close.
     */

    private static void closeStream(Closeable stream) {
        if (stream != null) {
            try {
                stream.close();
            } catch (IOException e) {
                // Ignore
            }
        }
    }
}


assets/[LANGUAGE FOLDER]/EULA
Codice (Text): [Seleziona]
Un semplicissimo file di testo con la vostra EULA, create una cartella in assets per ogni lignua che volete gestire con il relativo file EULA

Distinguete i vari path della cartella in base alla lingua
values-[LANG]/strings.xml
Codice (XML): [Seleziona]
 <string name="eula_title">License</string>
    <string name="eula_accept">Accept</string>
    <string name="eula_refuse">Decline</string>
   
    <string name="subpath">en</string>

Per usarlo
MainActivity.java
Codice (Java): [Seleziona]
public void onCreate(Bundle savedInstanceState) {      
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        Eula.show(this);
« Ultima modifica: 31 Gennaio 2012, 01:02:11 CET da xWOLKx, Reason: allegata immagine »

Offline bradipao

  • Moderatore globale
  • Utente storico
  • *****
  • Post: 4043
  • keep it simple
  • Respect: +567
    • Github
    • Google+
    • bradipao
    • Mostra profilo
  • Dispositivo Android:
    Nexus 5
  • Play Store ID:
    Bradipao
  • Sistema operativo:
    W7
Re:Visualizzare la licenza d'uso ad ogni modifica
« Risposta #1 il: 31 Gennaio 2012, 08:35:22 CET »
0
Io ho fatto una cosa leggermente diversa: mostro l'equivalente della EULA solo alla prima installazione, controllando se la preference app_versione è prensente o no; se è già presente allora è un aggiornamento e in tal caso mostro il whats_new (perchè gli utenti si chiedono sempre cosa è stato aggiornato).
NON rispondo a domande nei messaggi privati
Bradipao @ Play Store

Offline xWOLKx

  • Utente junior
  • **
  • Post: 72
  • Adoro quella citazione western!
  • Respect: +7
    • xWOLKx
    • Wolkrasgt
    • Mostra profilo
    • ZondeIT
  • Dispositivo Android:
    Samsung Galaxy Ace
  • Sistema operativo:
    Windows7
Re:Visualizzare la licenza d'uso ad ogni modifica
« Risposta #2 il: 31 Gennaio 2012, 11:56:07 CET »
0
In effetti ci ho pensato ed è fastidioso vedere l'eula ad ogni aggiornamento (magari un semplice bugfix).

Potrei visualizzarla solo quando cambia effettivamente l'EULA.
Eventualmente resta un buon codice per visualizzare il changelog che invece cambia ad ogni versione.

Ho notato però che ceti caratteri speciali (ex. trademark) non vengono riconosciuti. C'è un modo per impostare il charset?

Offline funcool

  • Nuovo arrivato
  • *
  • Post: 42
  • Respect: +3
    • Mostra profilo
  • Dispositivo Android:
    Acer Liquid CM 7.1
  • Play Store ID:
    elcasa
  • Sistema operativo:
    Windows 8
Re:Visualizzare la licenza d'uso ad ogni modifica
« Risposta #3 il: 08 Marzo 2012, 19:39:30 CET »
0
1) secondo voi è necessario mostrare l'eula al primo avvio oltre al changelog o potrebbe bastare scrivere "usando quest'app accettate automaticamente l'eula che trovate nelle info" nel dialog del changelog ? adobe su photoshop per android fa cosi

2) pensavo di usare ACRA per ricevere il logcat in caso di force close.. acra può agire sia di nascosto (default) che con richiesta... se lo facessi agire senza richiesta scrivendo nell'eula che l'app invia i logcat in caso di force close.. è un po' esagerata la cosa o vado tranquillo ?
« Ultima modifica: 08 Marzo 2012, 20:07:27 CET da funcool »

Offline xWOLKx

  • Utente junior
  • **
  • Post: 72
  • Adoro quella citazione western!
  • Respect: +7
    • xWOLKx
    • Wolkrasgt
    • Mostra profilo
    • ZondeIT
  • Dispositivo Android:
    Samsung Galaxy Ace
  • Sistema operativo:
    Windows7
Re:Visualizzare la licenza d'uso ad ogni modifica
« Risposta #4 il: 08 Marzo 2012, 20:09:26 CET »
0
Secondo me dipende, per app ti  ogoogle maps dove un aggiornamento comporta novità inaspettate il changelog ha il suo significato all'avvio, altrimenti trovo piu comodo una sezione apposta nella app e l'aggiornamento della descrizione sul market che vado puntualmente a leggere prima di scaricare l'update.

Cmq io credo siamo davanti a uno di quei casi dove tizio dice A e caio B, la regola generale direbbe non mostrare nulla se non strettamente necessario :D