In questo articolo vedremo come farlo, ne capiremo gli strumenti fondamentali e ne otterremo una dimostrazione con un semplice esempio.<\/p>\n
Primo passo: impostiamo un progetto Google<\/h2>\n
Molti concetti che incontreremo nel corso del tutorial rappresentano i fondamenti comuni per l’accesso a tutti i\u00a0servizi Google. Uno di questi \u00e8 la configurazione di un “progetto”, la controparte remota con cui la nostra app dialogher\u00e0. Questo deve essere fatto all’interno di un pannello web chiamato\u00a0Google Developers Console <\/a>cui potremo accedere\u00a0con un normalissimo account Gmail che probabilmente gi\u00e0 stiamo usando\u00a0da tempo per la posta elettronica.<\/p>\n L’interfaccia che ci ospiter\u00e0\u00a0serve a gestire l’insieme dei progetti Google che fanno da backend alle nostre applicazioni\u00a0e se saremo al\u00a0nostro primo accesso alla console probabilmente sar\u00e0 vuoto. Creeremo il progetto<\/strong> tramite il pulsanse Create Project<\/em> e la finestra di dialogo che si aprir\u00e0 non chieder\u00e0 altro che il nome da\u00a0assegnargli. Tale identificativo \u00e8 esclusivamente per uso “interno” alla console pertanto possiamo sceglierlo liberamente purch\u00e8 abbia per noi un significato preciso.<\/p>\n Fatto ci\u00f2 avremo accesso direttamente ad un pannello in cui potremo gestire le risorse che fanno parte del singolo progetto. Abbiamo bisogno di fare due cose qui:<\/p>\n Per abilitare le API<\/strong>, apriremo una sezione denominata API Manager e cercheremo, come mostrato in figura, le Calendar API. Una volta trovate sar\u00e0 sufficiente cliccarvi sopra e poi il tasto Enable API<\/em> che apparir\u00e0 immediatamente.<\/p>\n Per creare le chiavi di accesso<\/strong>\u00a0apriremo\u00a0il pannello Credentials<\/em> dal menu laterale sinistro e chiederemo di avere un OAuth Client ID che fornir\u00e0 un tipo di autenticazione in grado di concedere\u00a0l’accesso agli account Google.<\/p>\n Osservando la figura vediamo che i dati da fornire sono:<\/p>\n A questo punto potr\u00e0 essere creato il nostro client ID. Fondamentale ricordare che qualora il package realmente usato nel codice Java dell’app fosse diverso da quello inserito nella definizione delle credenziali Google, sar\u00e0 necessario cambiarlo o creare un altro client ID OAuth2.<\/p>\n La configurazione del nostro progetto in Android Studio passer\u00e0 invece per una corretta definizione del file build.gradle<\/strong>. Creando un nuovo progetto andr\u00e0 benissimo quello fornito dall’IDE ma il blocco delle dipendenze dovr\u00e0 richiedere il corretto set di librerie per la connessione ai servizi Google:<\/p>\n Anche il file AndroidManifest.xml<\/strong> sar\u00e0 piuttosto semplice ma dovremo fare attenzione a rispettare due regole:<\/p>\n Lo scopo del nostro esempio \u00e8 vedere le fasi di accesso al Google Calendar da app Android. Lo faremo inserendo degli eventi in un calendario manualmente, ad esempio tramite il nostro smartphone, e recuperando dall’app gli eventi di un dato periodo e mostrandoli in una\u00a0normale ListView. Non mostreremo nell’esempio le fasi dell’inserimento tramite codice ma, come accenneremo, useranno gli stessi strumenti della lettura.<\/p>\n Queste le fasi dell’esperimento:<\/p>\n La query che effettueremo sul calendario restituir\u00e0 una lista di oggetti Event<\/em> ognuno dei quali contenente\u00a0i soliti dati che siamo abituati ad inserire registrando a mano i nostri impegni.<\/p>\n Per visualizzare gli eventi, creeremo un nostro adapter che estende\u00a0la classe ArrayAdapter<\/em>. Di ogni evento verranno visualizzati solo due campi: il summary e la data di inizio dell’evento. Ovviamente sulla falsa riga di quanto faremo qui insieme l’esempio pu\u00f2 essere espanso a volont\u00e0.<\/p>\n Questa la classe EventAdapter:<\/p>\n Il metodo getView<\/em> presente in ogni Adapter \u00e8 stato sottoposto a override<\/em> per personalizzare la visualizzazione. Si noti che si controlla se il metodo getDateTime<\/em> ha restituito un valore null in quanto ci\u00f2 si verifica quando\u00a0l’evento copre l’intera giornata e non solo alcune ore.<\/p>\n Il layout che da forma alle singole righe della ListView \u00e8 molto semplice – due TextView in un LinearLayout – e verr\u00e0 posto nel file di risorse \/res\/layout\/row.xml<\/strong>:<\/p>\n <\/p>\n Infine arriviamo alla nostra Activity:<\/p>\n Buona parte del funzionamento gira attorno\u00a0al metodo onResume<\/em>. In esso si controlla se \u00e8 gi\u00e0 stato associato un nome di account all’oggetto di classe GoogleAccountCredential che si occuper\u00e0 del login presso il servizio. Se \u00e8 ancora nullo si far\u00e0 apparire una finestra con cui Android chieder\u00e0 di selezionare un account presente\u00a0nel\u00a0sistema o di\u00a0registrarne uno nuovo. Pronte le credenziali\u00a0si eseguir\u00e0 il task in background rappresentato dalla classe CalendarQueryTask<\/em>. Questo richieder\u00e0 i dati nel metodo\u00a0doInBackground<\/em> che agisce su un thread secondario mentre i metodi onPreExecute<\/em> e onPostExecute<\/em> si occuperanno, rispettivamente, di far apparire la finestra con la barra di progresso e di farla scomparire con contestuale aggiornamento dell’adapter.<\/p>\n Da notare che all’interno del costruttore di CalendarQueryTask viene allocato un oggetto Calendar che costituir\u00e0 il nostro collegamento al servizio. Tramite questo potremo fare varie operazioni. Noi effettueremo una query con il metodo list <\/em>invocato sulla collezione di eventi events\u00a0<\/em>e nello specifico chiederemo dieci eventi a partire dalla data di oggi.<\/p>\n I passi indicati nel codice come l’accesso tramite credenziali e la verifica della disponibilit\u00e0 dei\u00a0Google Play Services nel terminale (metodo isGooglePlayServicesAvailable) incontrati\u00a0nell’esempio sono utili sia in altri tipi di interazione con Calendar API sia nel dialogo con altri servizi di Big G.<\/p>\n Per effettuare la vera sperimentazione, potremo aprire l’app Calendar nel nostro dispositivo Android ed inserire manualmente un paio di eventi.<\/p>\n Uno per il 31 dicembre:<\/p>\n e l’altro per l’8 gennaio:<\/p>\n La nostra app mostrer\u00e0 il seguente layout:<\/p>\n\n
![\"android-integrare-app-con-google-calendar_01\"](\"http:\/\/www.devapp.it\/wordpress\/wp-content\/uploads\/2015\/12\/android-integrare-app-con-google-calendar_01.jpg\")
<\/a><\/p>\n![\"android-integrare-app-con-google-calendar_02\"](\"http:\/\/www.devapp.it\/wordpress\/wp-content\/uploads\/2015\/12\/android-integrare-app-con-google-calendar_02.jpg\")
<\/a><\/p>\n\n
![\"android-integrare-app-con-google-calendar_03\"](\"http:\/\/www.devapp.it\/wordpress\/wp-content\/uploads\/2015\/12\/android-integrare-app-con-google-calendar_03.jpg\")
<\/a><\/li>\nConfigurazione del progetto Android<\/h2>\n
...\r\n...\r\ndependencies {\r\n compile fileTree(dir: 'libs', include: ['*.jar'])\r\n compile 'com.android.support:appcompat-v7:23.0.1'\r\n compile 'com.google.android.gms:play-services-identity:7.8.0'\r\n compile('com.google.api-client:google-api-client-android:1.20.0') {\r\n exclude group: 'org.apache.httpcomponents'\r\n }\r\n compile('com.google.apis:google-api-services-calendar:v3-rev125-1.20.0') {\r\n exclude group: 'org.apache.httpcomponents'\r\n }\r\n\r\n}\r\n...\r\n...<\/pre>\n\n
<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<manifest xmlns:android=\"http:\/\/schemas.android.com\/apk\/res\/android\"\r\n package=\"it.devapp.googlecalendarintegration\" >\r\n\r\n <uses-permission android:name=\"android.permission.INTERNET\" \/>\r\n <uses-permission android:name=\"android.permission.ACCESS_NETWORK_STATE\" \/>\r\n <uses-permission android:name=\"android.permission.GET_ACCOUNTS\" \/>\r\n <uses-permission android:name=\"android.permission.MANAGE_ACCOUNTS\" \/>\r\n <uses-permission android:name=\"android.permission.USE_CREDENTIALS\" \/>\r\n\r\n <application\r\n android:allowBackup=\"true\"\r\n android:icon=\"@mipmap\/ic_launcher\"\r\n android:label=\"@string\/app_name\"\r\n android:supportsRtl=\"true\"\r\n android:theme=\"@style\/AppTheme\" >\r\n <meta-data\r\n android:name=\"com.google.android.gms.version\"\r\n android:value=\"@integer\/google_play_services_version\" \/>\r\n\r\n <activity android:name=\".MainActivity\" >\r\n <intent-filter>\r\n <action android:name=\"android.intent.action.MAIN\" \/>\r\n\r\n <category android:name=\"android.intent.category.LAUNCHER\" \/>\r\n <\/intent-filter>\r\n <\/activity>\r\n <\/application>\r\n\r\n<\/manifest><\/pre>\n
Struttura dell’esempio<\/h2>\n
\n
Il nostro Adapter<\/h2>\n
public class EventAdapter extends ArrayAdapter<Event>\r\n{\r\n private List<Event> events;\r\n private Context context;\r\n private int layoutId;\r\n private SimpleDateFormat simple=new SimpleDateFormat(\"dd\/MM\/yyyy\");\r\n\r\n public EventAdapter(Context context, int resource) {\r\n super(context, resource);\r\n this.context=context;\r\n layoutId=resource;\r\n }\r\n\r\n @Override\r\n public void addAll(Collection<? extends Event> collection) {\r\n clear();\r\n super.addAll(collection);\r\n }\r\n\r\n @Override\r\n public View getView(int position, View convertView, ViewGroup parent) {\r\n Event e=getItem(position);\r\n \r\n View v= LayoutInflater.from(context).inflate(layoutId, null);\r\n TextView txt_event= (TextView) v.findViewById(R.id.event);\r\n TextView txt_date= (TextView) v.findViewById(R.id.date);\r\n\r\n Calendar cal=Calendar.getInstance();\r\n DateTime dt=e.getStart().getDateTime();\r\n if (dt==null)\r\n dt=e.getStart().getDate();\r\n cal.setTimeInMillis(dt.getValue());\r\n\r\n txt_event.setText(e.getSummary());\r\n txt_date.setText(simple.format(cal.getTime()));\r\n return v;\r\n }\r\n}\r\n<\/pre>\n<LinearLayout xmlns:android=\"http:\/\/schemas.android.com\/apk\/res\/android\"\r\n android:layout_width=\"match_parent\"\r\n android:layout_height=\"wrap_content\"\r\n android:padding=\"15dp\"\r\n android:background=\"#48B1F7\"\r\n android:orientation=\"vertical\">\r\n <TextView\r\n android:layout_width=\"wrap_content\"\r\n android:layout_height=\"wrap_content\"\r\n android:textColor=\"#FFFFFF\"\r\n android:textSize=\"20dp\"\r\n android:textStyle=\"bold\"\r\n android:id=\"@+id\/event\"\/>\r\n <TextView\r\n android:layout_width=\"wrap_content\"\r\n android:layout_height=\"wrap_content\"\r\n android:textColor=\"#FFFFFF\"\r\n android:textSize=\"15dp\"\r\n android:id=\"@+id\/date\"\/>\r\n<\/LinearLayout><\/pre>\n
L’Activity<\/h2>\n
public class MainActivity extends ListActivity {\r\n static final int REQUEST_ACCOUNT_PICKER = 101;\r\n static final int REQUEST_GOOGLE_PLAY_SERVICES = 102;\r\n\r\n GoogleAccountCredential login;\r\n\r\n private static final String[] SCOPES = { CalendarScopes.CALENDAR_READONLY };\r\n\r\n private EventAdapter adapter;\r\n\r\n @Override\r\n protected void onCreate(Bundle savedInstanceState) {\r\n super.onCreate(savedInstanceState);\r\n adapter=new EventAdapter(this, R.layout.row);\r\n setListAdapter(adapter);\r\n getListView().setDividerHeight(10);\r\n\r\n login = GoogleAccountCredential.usingOAuth2(\r\n getApplicationContext(), Arrays.asList(SCOPES))\r\n .setBackOff(new ExponentialBackOff())\r\n .setSelectedAccountName(null);\r\n }\r\n\r\n @Override\r\n protected void onResume() {\r\n super.onResume();\r\n if (isGooglePlayServicesAvailable()) {\r\n if (login.getSelectedAccountName() == null) {\r\n startActivityForResult(login.newChooseAccountIntent(), REQUEST_ACCOUNT_PICKER);\r\n } else {\r\n if (isConnected()) {\r\n new CalendarQueryTask(login).execute();\r\n }\r\n }\r\n }\r\n }\r\n\r\n @Override\r\n protected void onActivityResult(\r\n int requestCode, int resultCode, Intent data) {\r\n super.onActivityResult(requestCode, resultCode, data);\r\n switch(requestCode) {\r\n case REQUEST_GOOGLE_PLAY_SERVICES:\r\n if (resultCode != RESULT_OK) {\r\n isGooglePlayServicesAvailable();\r\n }\r\n break;\r\n case REQUEST_ACCOUNT_PICKER:\r\n if (resultCode == RESULT_OK && data != null &&\r\n data.getExtras() != null) {\r\n String accountName = data.getStringExtra(AccountManager.KEY_ACCOUNT_NAME);\r\n if (accountName != null) {\r\n login.setSelectedAccountName(accountName);\r\n }\r\n }\r\n }\r\n\r\n super.onActivityResult(requestCode, resultCode, data);\r\n }\r\n\r\n private boolean isConnected() {\r\n ConnectivityManager connMgr =\r\n (ConnectivityManager) getSystemService(Context.CONNECTIVITY_SERVICE);\r\n NetworkInfo networkInfo = connMgr.getActiveNetworkInfo();\r\n return (networkInfo != null && networkInfo.isConnected());\r\n }\r\n\r\n private boolean isGooglePlayServicesAvailable() {\r\n final int connectionStatusCode =\r\n GooglePlayServicesUtil.isGooglePlayServicesAvailable(this);\r\n if (GooglePlayServicesUtil.isUserRecoverableError(connectionStatusCode)) {\r\n GooglePlayServicesUtil.getErrorDialog(\r\n connectionStatusCode,\r\n this,\r\n REQUEST_GOOGLE_PLAY_SERVICES).show();\r\n return false;\r\n } else if (connectionStatusCode != ConnectionResult.SUCCESS ) {\r\n return false;\r\n }\r\n return true;\r\n }\r\n\r\n private class CalendarQueryTask extends AsyncTask<Void, Void, List<Event>> {\r\n private com.google.api.services.calendar.Calendar mService = null;\r\n private ProgressDialog progress=null;\r\n\r\n public CalendarQueryTask(GoogleAccountCredential credential) {\r\n HttpTransport client = AndroidHttp.newCompatibleTransport();\r\n JsonFactory json = JacksonFactory.getDefaultInstance();\r\n mService = new com.google.api.services.calendar.Calendar.Builder(\r\n client, json, credential)\r\n .build();\r\n }\r\n\r\n @Override\r\n protected List<Event> doInBackground(Void... params) {\r\n try {\r\n DateTime now = new DateTime(System.currentTimeMillis());\r\n\r\n Events events = mService.events()\r\n .list(\"primary\")\r\n .setMaxResults(10).setTimeMin(now).setOrderBy(\"startTime\")\r\n .setSingleEvents(true)\r\n .execute();\r\n return events.getItems();\r\n } catch (Exception e) {\r\n \/\/ gestione dell'errore\r\n return null;\r\n }\r\n }\r\n\r\n @Override\r\n protected void onPreExecute() {\r\n\r\n progress=ProgressDialog.show(MainActivity.this,\"Google Calendar\", \"Collegamento in corso...\",true);\r\n progress.show();\r\n }\r\n\r\n @Override\r\n protected void onPostExecute(List<Event> output) {\r\n if (progress!=null)\r\n progress.dismiss();\r\n adapter.addAll(output);\r\n }\r\n }\r\n}<\/pre>\n![\"android-integrare-app-con-google-calendar_04\"](\"http:\/\/www.devapp.it\/wordpress\/wp-content\/uploads\/2015\/12\/android-integrare-app-con-google-calendar_04.jpg\")
<\/a><\/p>\n![\"android-integrare-app-con-google-calendar_05\"](\"http:\/\/www.devapp.it\/wordpress\/wp-content\/uploads\/2015\/12\/android-integrare-app-con-google-calendar_05.jpg\")
<\/a><\/p>\n
![\"android-integrare-app-con-google-calendar_06\"](\"http:\/\/www.devapp.it\/wordpress\/wp-content\/uploads\/2015\/12\/android-integrare-app-con-google-calendar_06.jpg\")
<\/a><\/p>\n