Tutorial 40 - Inviare email con allegati da App Inventor

Premessa: Questo è un tutorial abbastanza complicato, infatti App Inventor nativamente non offre la possibilità di inviare email con allegati.

Il tutorial è composto solo da testo e screenshot, l'utente deve avere una buona padronanza sia di App Inventor che dei servizi Google in generale

Detto questo, vediamo come, sfruttando uno script python caricato su Google App Engine è possibile inviare da App Inventor delle mail con anche un allegato.

Il metodo non usa activitystarter (come visto nel tutorial 14) e quindi non si aprirà il client gmail, ma usa il componente web per dialogare con il web service, volendo la mail viene mandata anche senza premere un tasto "send" visto che si usa il componente web col metodo POST.


Vediamo i requisiti richiesti:
1 - Account su Google App Engine (gratuito per il servizio base)
2 - Installazione di Python
3 - Installazione di Google App Engine per Python

Queste invece le limitazioni:
1 - Possibilità di inviare allegati di dimensione massima 1Mb
2 - Possibilità di inviare massimo 100 email al giorno
3 - Il mittente della mail è fisso ed è definito all'interno dello script python

Pagando il servizio App Engine si possono superare le limitazioni 1 e 2, il tutorial considera solo le possibilità date dall'account "base" e quindi ha tutte e 3 le limitazioni elencate sopra.

Scaricate il file sorgente per App Inventor App Inventor Source File
e il pacchetto zip contenente lo script in python App Engine Python code

Partiamo con la creazione di un account su Google App Engine

visitiamo la pagina https://developers.google.com/appengine/ e colleghiamo il nostro account google al servizio.
Poi clicchiamo su Google App Engine SDK for Python e scarichiamo il file .msi del pacchetto di installazione:

Andiamo ora a scaricare Python da http://www.python.org/download/, scegliamo l'ultima versione disponibile del branch 2.7 (versione 32 o 64 bit a seconda del vostro s.o.)

Cominciamo le installazioni partendo da Python:

In questo tutorial lascio tutte le destinazioni e tutte le opzioni di default
Installiamo ora App Engine for Python (come vedete trova la precedente installazione di Python che è prerequisito per il corretto funzionamento di App Engine)

Se tutto ha funzionato correttamente potrete eseguire "Run Launcher" (che utilizzeremo tra poco) lasciando la finestra per il momento in background...

Torniamo in App Engine e creiamo la nostra nuova applicazione, tale applicazione sarà il cuore vero e proprio della nostra app.
E' un programma scritto in Python che crea un web service per la gestione dell'invio delle mail, si ringrazia sentitamente l'autore ShivalWolf (shivalwolf@gmail.com), David Wolber (wolber@usfca.edu) e Hal Abelson per il tutorial originale che trovate qua

Non vi preoccupate ci sono solo poche righe di codice da cambiare, se conoscete un pò di Python o java forse potete anche capirci qualcosa di quel che c'è scritto li dentro ... :) io sinceramente non ho analizzato più di tanto la cosa...

Torniamo su https://appengine.google.com/ e selezioniamo Create Application:

Ora inseriamo questi dati con molta attenzione:

E facciamo particolare attenzione al campo "Application Identifier", questo dovrà essere identico a quello inserito nel file app.yaml alla voce application,
potete (e dovete) ovviamente inserire un nome qualsiasi (non quello del mio esempio!), mettetelo tutto minuscolo e senza spazi e segnatevelo da qualche parte...

Lanciamo ora Google App Engine Launcher cercandolo nel nostro menù start:

Carichiamo ora il nostro script scegliendo la directory in cui lo abbiamo precedentemente salvato (File - Add Existing Application), la directory è quella dove avrete scaricato il file python linkato all'inizio dell'articolo

Dopo aver caricato il progetto selezioniamo la voce Edit per editare il file app.yaml

Qui alla voce application dobbiamo scrivere esattamente lo stesso nome applicazione che avevamo dato come "Application Identifier" nell'interfaccia web di App Engine

Ora usando un qualsiasi text editor apriamo il file main.py (è un normale file di testo, io consiglio PSPad per l'editing dei file, freeware e molto versatile)

Qui dobbiamo indicare l'indirizzo mail da cui partiranno le email nella nostra applicazione, tale indirizzo deve essere un amministratore dell'app che gira in App Engine, quindi può essere lo stesso che avete usato per la registrazione ad AE oppure un altro a patto che venga aggiunto poi come amministratore di questa app in App Engine
Authkey è la chiave per l'autenticazione in AE, deve essere uguale a quella che poi inseriremo nel blocks editor (nell'esempio qui sopra è "randomvalue", potete lasciarla così o mettere un'altra stringa, se la cambiate ricordate di cambiarla anche in blocks editor...)

A questo punto possiamo provare a far girare lo script in locale sul nostro pc, premiamo Run e poi Logs:

Se è tutto corretto vedremo una schermata che ci dice che l'app sta girando correttamente:

Allora a questo punto possiamo fare il "deploy" della nostra app in App Engine, in pratica stiamo caricando il nostro script nei server di Google e lo rendiamo disponibile come un servizio web per la nostra app che poi andremo a scrivere:

Inseriamo le nostre credenziali di accesso a Google App Engine e premiamo ok, si aprirà un'altra finestra dopo circa 30 secondi dovremmo avere questo risultato:

In pratica ci conferma che l'app è caricata in App Engine e sta girando correttamente.

Passiamo ora a vedere rapidamente la nostra app creata in App Inventor, ovviamente io vi ho messo a disposizione un esempio solo per farvi capire il funzionamento base poi starà a voi personalizzare l'app in base alle vostre esigenze. (tra l'altro il mio esempio NON funziona perchè ho cambiato appositamente il nome dell'app e l'indirizzo email sia nello script che nell'app App Inventor...) :)

Vi consiglio di aprire a tutto schermo l'immagine del blocks editor in modo da poterla consultare più comodamente:

Ovviamente cambiamo eventualmente "AuthKey" con la chiave che abbiamo messo nel file main.py

"AppEngine_Address" deve essere uguale al nostro ApplicationIdentifier, preceduto da https:// (nel mio esempio https://seblogappemail.appspot.com)

"Attachment" può avere il valore di true o false, se è true bisogna specificare in "FiletoAttach" il path completo del file da allegare e in "FileNAME" solo il nome del file
se è false la mail viene inviata senza allegati

Il servizio in python che abbiamo creato funziona tramite il componente web ed il metodo POST e vuole la seguente sintassi:

• 1st Field = AuthKey
• 2nd Field = To Address
• 3rd Field = Subject
• 4th Field = Body
• 5th Field = (yes/no) if you have an attachment
• 6th Field = attachment file name
• 7th Field = attachment ID (This is provided by the code)

Tutti questi campi vanno separati dai tre caratteri "|||" come vedete nel blocks editor

Guardiamo solo la parte di quando si clicca il pulsante Send:
prima verifica se ci sono tutti i campi compilati con la funzione TestFields,se ok controllo poi se ho attachment true o false, partiamo dal caso in cui non si abbia attachment,

in pratica vedete che basta impostare la chiamata al componente web dandogli l'url del nostro servizio App Engine con il suffisso /sendemail per dire che vogliamo mandare una mail e poi comporre la parte Post con una grossa "make text" dove passiamo tutti i parametri come abbiamo visto nelle istruzioni di poco fa, quindi in questo caso solo AuthKey, email destination, subject e body tutti separati dal testo "|||"

App Engine a questo punto analizzerà la richiesta http POST ed invierà la mail come specificato in App Inventor, senza ulteriore interazione da parte dell'utente.

L'altro grosso blocco relativo a Web1.GotText gestisce il codice di ritorno di App Engine e ci dice se la mail è stata inviata correttamente o meno andando a vedere cosa ritorna in responseContent
In realtà questo blocco gestisce anche l'eventuale allegato, è un pò complicato da spiegare ma, se si lavora con l'allegato bisogna fare due richieste POST;
prima si fa una POST con il comando /attach e si da il file da allegare,
la prima risposta nel GotText da App Engine sarà FileAttached: con un hash univoco che indica il nostro file nei server App Engine, a quel punto si rifà un'altra richiesta di POST con /sendmail ma stavolta anche con l'attach specificato però come appunto "hash" + filename che può così essere correttamente letto da App Engine (il valore dell'hash ce lo ha dato App Engine stesso alla prima richiesta POST)

Il tutto suona abbastanza complicato ma caricando voi l'app e facendo un pò di test son sicuro capirete meglio il funzionamento.

E' possibile monitorare le richieste che arrivano ad App Engine accedendo alla finestra dei log (in Admin Console)
per esempio dopo aver mandato una mail con attach vedremo una cosa di questo tipo:

Dove si possono vedere le due richieste, la prima con /attach e la seconda con /sendmail (ed i relativi parametri)
Se la richiesta non va a buon fine avremo un log con un messaggio d'errore (tipo se l'attach supera 1Mb)

Nel nostro esempio l'app mostrava questo, dopo aver premuto il tasto Send partono le richieste ad AE:

Quando scrive "Email Sent" ovviamente vuol dire che la mail è stata inviata correttamente, se ci fosse qualche errore lo visualizzerete o nell app o tramite notifier che vi compare direttamente nello smartphone (per esempio se sbagliate il path del file da mettere in allegato vedrete errore 1104)
la mail ricevuta in gmail è questa (ovviamente possiamo spedire a qualunque indirizzo mail)

Phew! abbiamo finito, come vedete la cosa non è per nulla semplice e le limitazioni sono alquanto fastidiose (ma d'altronde Google non ci può regalare proprio tutto ed App Engine è spesso dedicato ad un utenza business)
Ma potrebbe essere interessante realizzare nella nostra app una parte per l'invio delle mail in automatico usando il metodo qui esposto.
Con relativamente poche modifiche si può anche allegare alla mail una foto scattata dalla fotocamera (usando il componente camera e poi l'imagepicker e impostando correttamente il path e il nome della foto scattata)
oppure un immagine presa dalla galleria, le opzioni ovviamente sono molte e limitate quasi solo dalla nostra fantasia!!!

Per le discussioni (se mi avete letto fin qua) usate il forum o i commenti qui sotto
a presto! ormai potete fregiarvi dell'appellativo di Masters of App Inventor :)