Creazione di un client Twitter per Android installazione e panoramica

Inutile dire che molte persone usano i dispositivi mobili per connettersi ai servizi di social media. In questa serie di tutorial, creeremo un client Twitter di base per la piattaforma Android. Useremo la libreria Twitter4J per connetterci a Twitter. L'app mostrerà la linea temporale dell'utente, invierà tweet, retweet e risponderà ai tweet.

Ecco un'anteprima del risultato finale:




Disponibile anche in questa serie:

  1. Creazione di un client Twitter per Android: installazione e panoramica
  2. Creazione di un client Twitter per Android: creazione dell'interfaccia
  3. Creazione di un client Twitter per Android: creazione di un database cronologico
  4. Creazione di un client Twitter per Android: recupero degli aggiornamenti tramite un servizio
  5. Creazione di un client Twitter per Android: Tweeting, Retweeting e Replying

Passo 1: Capire come funzionerà l'app

Prima di iniziare a costruire l'app, prendiamoci un momento per esaminare cosa stiamo cercando di ottenere e come lo faremo! L'app coinvolgerà una varietà di tecniche e utilità Java / Android tra cui un database SQLite, un servizio, un ricevitore Broadcast, un adattatore e i metodi Twitter4J stessi.

Cosa farà l'App

Quando l'utente esegue l'applicazione per la prima volta, verrà presentato un prompt che chiede loro di accedere a Twitter per autorizzare l'applicazione a utilizzare il proprio account. A questo punto verranno reindirizzati a una pagina nel browser Web, dove Twitter gestirà l'accesso e l'autorizzazione per l'accesso. L'utente verrà quindi reindirizzato all'app, con Twitter che restituisce le informazioni sull'autorizzazione necessarie per implementare le varie funzioni di tweeting e timeline.

Una volta che l'utente ha concesso all'app l'autorizzazione per utilizzare il proprio account, e in seguito all'app successiva, la prima cosa che vedranno sarà la timeline di Twitter di casa (come nell'immagine sopra). La linea temporale iniziale mostra inizialmente i tweet più recenti, con i nuovi tweet aggiunti con il passare del tempo. Mentre l'utente sta interagendo con l'app, un servizio preleverà periodicamente nuovi tweet e il codice aggiornerà di conseguenza la visualizzazione della sequenza temporale.

All'interno di ciascun tweet nella timeline, l'utente sarà in grado di vedere il nome utente Twitter dell'account in questione, l'ora in cui è stato inviato il tweet relativo a ora, il testo tweeted e l'immagine dell'icona del profilo utente. Se ci sono URL nel testo tweet, l'app li tratterà automaticamente come collegamenti Web in modo che l'utente possa fare clic su di essi per accedere alle risorse collegate. L'utente sarà inoltre in grado di retwittare e rispondere a ciascun tweet nella timeline.

Per inviare un tweet, l'utente premerà il pulsante Tweet nella parte superiore dello schermo, che li porterà alla schermata Attività Tweet. Qui possono entrare e inviare i loro tweet. Se l'utente sceglie di rispondere a un tweet nella sua timeline, verrà anche portato alla schermata Tweet, con il nome utente inserito automaticamente nel campo di testo tweet e il codice sottostante che memorizza le informazioni richieste per rispondere a un particolare tweet.

Questa app ha un mandato molto specifico, ma una volta che hai finito di svilupparlo, puoi ovviamente migliorarlo. Alla fine dell'ultimo tutorial della serie, presenteremo alcuni suggerimenti per ulteriori sviluppi, come un'attività per la visualizzazione dei profili utente di Twitter. L'app come lo svilupperemo qui consentirà all'utente di accedere al profilo di un utente di Twitter nel browser Web selezionando il proprio nome utente nella timeline, collegandosi al sito Web di Twitter per consentire all'utente di accedere a funzioni che non abbiamo fornito all'interno dell'app stessa.

Come l'app farà tutto questo

L'app client Twitter avrà due attività principali: una per la timeline e una per tweeting. All'avvio dell'app, verrà creato un database SQLite per archiviare i tweet della timeline home, con una scheda che associa le righe del database alle viste nell'interfaccia utente dell'applicazione. L'app avvierà anche un servizio da eseguire mentre l'utente interagisce con esso, aggiornando la timeline con nuovi tweet quando disponibili. Per fare ciò, l'app invierà e riceverà trasmissioni quando saranno stati recuperati nuovi aggiornamenti, in modo che possa aggiornare i tweet visibili.

L'applicazione conterrà solo alcune classi, ma queste classi sono relativamente complesse. Dovremo anche importare la libreria Twitter4J, creare e fare riferimento a vari file di risorse e modificare il manifesto del progetto. Se questo sembra molto da fare, non ti preoccupare! Lavoreremo e spiegheremo ogni passaggio in dettaglio. Prepariamoci.


Passaggio 2: registra l'app con Twitter

Visita il sito di Twitter Developers e accedi con i tuoi dettagli di accesso a Twitter per registrare la tua app. Crea una nuova app nell'interfaccia che vedi lì. Inserisci un nome per la tua app. Per questa serie di tutorial l'app si chiamerà TwitNice, ma dovrai scegliere il tuo nome. Inserisci una descrizione e un URL del sito web, che può essere semplicemente la tua home page. Puoi inserire lo stesso indirizzo (o qualsiasi indirizzo che possiedi) come URL di richiamata; non ne avremo bisogno per l'app, ma devi inserire qualcosa per completare la registrazione.


Dopo aver creato l'app nell'interfaccia per sviluppatori di Twitter, dovresti essere in grado di vederne i dettagli. Passare alla scheda Impostazioni per l'app e scorrere fino alla sezione Tipo di applicazione. Selezionare Leggi e scrivi o Leggi, scrivi e accedi ai messaggi diretti. Per questa serie non accediamo ai messaggi diretti, ma potresti voler estendere la tua app per farlo in futuro. Puoi modificare queste impostazioni in qualsiasi momento. Fare clic sul pulsante nella parte inferiore della pagina per aggiornare le impostazioni dell'applicazione.


Seleziona la scheda Dettagli per la tua applicazione Twitter. Questa area contiene dettagli che dovrai notare. Nella sezione delle impostazioni OAuth, copia i valori per Consumer Key e Consumer Secret in un file sul tuo computer per riferimento futuro. Questi dovrebbero essere entrambi privati. Useremo la chiave OAuth e il segreto all'interno del codice dell'applicazione per svolgere le funzioni di Twitter.


Queste impostazioni servono a verificare l'accesso degli sviluppatori per questa applicazione. Successivamente, avremo anche bisogno di implementare la verifica dell'utente e ottenere il permesso di interagire con i loro tweet.


Passaggio 3: crea un nuovo progetto in Eclipse

È tempo di creare il tuo progetto. In Eclipse, scegli File, Nuovo, Progetto, quindi Progetto Android. Inserisci il nome del tuo progetto, seleziona Avanti e scegli il livello API 8 per assicurarti che il codice in questa serie di tutorial non causi problemi. Fare clic su Avanti e inserire il nome del pacchetto, quindi Fine per creare il nuovo progetto.



Passaggio 4: importa le risorse di Twitter4J

Useremo Twitter4J per gestire l'interazione con Twitter all'interno dell'app. Ciò comporta l'importazione della libreria in modo che possiamo creare oggetti definiti in essa, quindi utilizzare tali oggetti per chiamare i metodi necessari per accedere a Twitter. Visita il sito Twitter4J e scarica la versione stabile più recente della libreria. Una volta scaricato, decomprimi il file zippato in un percorso a scelta all'interno del file system sul tuo computer.

Ora dobbiamo aggiungere la libreria Twitter4J al percorso di creazione della tua app. Per fare ciò, selezionare il progetto in Eclipse Package Explorer, quindi selezionare il menu della barra degli strumenti Progetto, quindi Proprietà. La finestra Proprietà dovrebbe essere aperta. Seleziona Percorso build Java, quindi la scheda Librerie.

Per aggiungere la libreria Twitter4J al progetto, selezionare Aggiungi JAR esterni, quindi individuare la posizione del file JAR principale per Twitter4J, che al momento è denominato "twitter4j-core-android-2.2.5.jar" ed è memorizzato all'interno la cartella "lib" della directory che hai decompresso. Per le versioni più recenti della libreria, potrebbe essere necessario cercare un file JAR leggermente diverso, ma dovrebbe avere più o meno lo stesso nome. Dopo aver aggiunto il file JAR lo vedrai nella scheda Librerie.


Fare clic su OK per chiudere la finestra Proprietà. Nella directory dell'applicazione, ora dovresti vedere il file JAR nella sezione Biblioteche di riferimento.


La tua applicazione ora ha la capacità di fare riferimento e utilizzare la funzionalità Twitter4J. Se in seguito decidi di aggiungere funzioni multimediali come il caricamento delle immagini alla tua app di Twitter, dovrai anche aggiungere il file JAR multimediale di Twitter4J, che si trova nella stessa posizione del JAR principale..


Passaggio 5: modifica del manifesto del progetto

Per completare la preparazione dell'app, modifichiamo il manifesto del progetto. Apri il file Manifest da Eclipse Package Explorer per vederlo nell'editor. Passa alla scheda AndroidManifest.xml per modificare direttamente il codice.


Dobbiamo preparare alcune aggiunte e modifiche al Manifesto per preparare l'app. Innanzitutto, aggiungi il seguente elemento di autorizzazione ovunque desideri, purché sia ​​esterno a tutti gli altri elementi tranne l'elemento manifest principale:

 

Ciò consente all'app di accedere alle risorse Internet. Nell'elemento dell'applicazione, modificare l'attività principale come segue:

            

All'interno del tag di attività di apertura, modifica l'attributo name in modo che si adatti al nome della principale classe Activity che hai scelto durante la creazione del tuo progetto, o un nome a tua scelta se non hai ottenuto Eclipse per generare automaticamente l'attività principale.

Gli elementi Filtro Intento specificano che l'attività principale deve essere avviata all'avvio dell'app e che sarà in grado di aprire il browser Web in modo che possiamo ottenere l'accesso dell'utente su Twitter per l'autorizzazione.

Si noti l'elemento dati nella parte inferiore di questo codice. Questo è anche per autenticare l'app. È possibile modificare il valore dell'attributo dello schema se lo si desidera, ma viene fatto riferimento nel codice dell'applicazione in modo da tenerlo a mente. Non importa ciò che hai inserito finchè corrisponde al codice Java che scriveremo in seguito.

Infine, aggiungi altri due elementi al tuo manifest, all'interno dell'elemento dell'applicazione, ma dopo il tag di chiusura per l'elemento Activity sopra:

  

L'elemento Activity è per la seconda schermata nell'app, che è per l'invio di tweet. Stiamo chiamando la classe di attività "NiceTweet". Se vuoi dare alla classe un nome diverso sentiti libero di farlo, ricordando che il nome della classe scelto dovrà corrispondere a questo elemento nel Manifest e riferimenti in vari punti nel codice Java dell'applicazione. Il secondo elemento riguarda il servizio che implementeremo per recuperare gli aggiornamenti di Twitter. Di nuovo, sentiti libero di cambiare il nome della classe, se lo desideri.


Fino alla prossima volta…

Abbiamo ora gettato le basi per il nostro client Twitter. Nel prossimo tutorial tratteremo di far accedere gli utenti a Twitter per consentire all'app di accedere ai propri account. Quando la pagina Twitter restituisce l'utente all'app, recupereremo le informazioni di autenticazione e le salveremo nelle preferenze dell'applicazione. Successivamente l'app sarà in grado di recuperare e visualizzare la timeline dell'utente e di inviare tweet dal proprio account.

Nella parte 2 di questa serie creeremo anche elementi dell'interfaccia utente per l'app, inclusi layout e risorse disegnabili. Nelle parti 3, 4 e 5 implementeremo il database, l'adattatore e il servizio per l'app, oltre a consentire all'utente di twittare, retwittare e rispondere ai tweet.