VNC++, control remoto desde Android

VNC++, con ol emo o desde And oid TRABAJO FIN DE GRADO CURSO 2012-2013 ´ Osca C espo Salaza Go ka Jimeno Ga ach´on Luis Vale o Ma ´ın Di ec o An onio Sa asa Cabezuelo Depa amen o de Sis emas In o m´a icos y Compu aci´on Facul ad de In o m´a ica Uni e sidad Complu ense de Mad id Mad id, Junio de 2013 iii Licencias c 2013 All Righ s Rese ed. Es a ob a es ´a bajo una Licencia C ea i e Commons A ibuci´on-Compa i Igual 3.0 Unpo ed. Ag adecimien os Ag adecemos a Johannew Shindelin po la comple a lib e ´ıa pa a VNC que c e´o y adem´as dis ibui la de o ma lib e. Y po supues o po su ines imable y desin e esada ayuda en el Mailing-lis de la p opia lib e ´ıa, an o de ´el como de Ch is ian Beie . Tambi´en ag adece a la web s acko e low h p://s acko e low.com/, conc e a- men e la secci´on de And oid, po su ce e a ayuda con esas ine i ables dudas que su gen al desa olla c´odigo desde ce o. Tambi´en, como no, ag adece a los desa ollado es de Google, que a a ´es de su web h p://de elope .and oid.com/index.h ml y cie os ejemplos cla e, han pe mi i- do culmina es e p oyec o. Menci´on especial pa a Axel Amigo, buen amigo nues o, que nos ayud´o poniendo oz al ´ıdeo explica i o del p oyec o, a Ra´ul C espo, po hace el mon aje que an o nos ha sa is echo a odos, y po supues o, a Se gio Ba asa po el an ´as ico logo ealizado pa a la aplicaci´on. Po ´ul imo ag adece a An onio Sa asa Cabezuelo, di ec o del p oyec o, po la con- ianza deposi ada en noso os y su ines imable ayuda du an e odo el p oceso. Tambi´en ag adecemos a odos los p o eso es de la Facul ad de In o m´a ica de la Uni e sidad Com- plu ense de Mad id po p opo ciona nos du an e odos es os a˜nos los conocimien os nece- sa ios pa a el desa ollo de es e p oyec o. ii Abs ac Nowadays he e a e a lo o VNC based applica ions o And oid. None heless, none o hese applica ions a e F ee So wa e and a e implemen ed using he NDK. The poin o his p ojec is o use he NDK po en ial o make a VNC based applica ion and y o ob ain a be e pe o mance han he o he applica ions implemen ed using only he SDK and all he sou ce code will be F ee So wa e. The p o ocol o comunica e wi h a VNC se e is called RFB. To implemen ing his p o ocol in his p ojec has been used he libVNCSe e lib a y. This lib a y acili a es he con ol o RFB. Wi hou libVNCSe e i would be mo e di icul o make ou own lib a y o manage he p o ocol. JNI is used as he amewo k o comunica e he na i e code wi h Ja a. The echnologies, as well as he p ocess used o buil his so wa e is going o be explained along his epo . Keywo ds VNC, And oid, C++, C, NDK, SDK, JNI, RFB. ix Resumen Hoy en d´ıa hay una g an can idad de aplicaciones basadas en VNC pa a And oid. Sin emba go, ninguna de es as aplicaciones son F ee So wa e y se implemen an u ilizando el NDK. El obje i o de es e p oyec o es u iliza el po encial NDK pa a hace una aplicaci´on basada en VNC y a a de ob ene un mejo endimien o que el es o de las aplicaciones implemen adas u ilizando s´olo el SDK y odo el c´odigo uen e se ´a F ee So wa e. El p o ocolo pa a comunica se con un se ido VNC se llama RFB. Pa a la implemen- aci´on de es e p o ocolo en es e p oyec o se ha u ilizado la lib e ´ıa libVNCSe e . Es a lib e ´ıa acili a el con ol de RFB. Sin libVNCSe e hab ´ıa sido m´as di ´ıcil hace nues a p opia lib e ´ıa pa a ges iona el p o ocolo. JNI se u iliza como amewo k pa a comunica el c´odigo na i o con Ja a. Las ecnolog´ıas, as´ı como el p oceso u ilizado pa a cons ui es e so wa e se explica ´a a lo la go de es a memo ia. Palab as cla e VNC, And oid, C++, C, NDK, SDK, JNI, RFB. 2 Cap´ı ulo 1 In oducci´on El desa ollo de las edes de elecomunicaciones ha pe mi ido que p og esi amen e el con ol emo o de un o denado pase de me as e minales de ex o a los esc i o ios emo os de hoy en d´ıa. La ecnolog´ıa de esc i o io emo o pe mi e la cen alizaci´on de aplicacio- nes que no malmen e se ejecu a ´ıan en el en o no de usua io. G acias a es a ecnolog´ıa el en o no de usua io (clien e) se con ie e en una simple e minal de en ada/salida. Todos los e en os de pulsaci´on de eclas y mo imien os del a ´on se ansmi en desde el clien e a un se ido donde la aplicaci´on los p ocesa como si se a asen de e en os locales. La imagen de la pan alla se de uel e al clien e y de es a mane a se puede con ola desde el e minal clien e la m´aquina donde se encuen a la aplicaci´on se ido . Es e p oyec o se cen a ´unicamen e en la ealizaci´on de una aplicaci´on clien e pa a And oid. De al mane a que la aplicaci´on se ido no es ´a desa ollada en es e p oyec o. Aunque m´as adelan e se p o undiza ´a en cuales son los obje i os conc e os de es e p o- yec o, con iene acla a que el obje i o e a desa olla un clien e VNC pa a And oid, que u iliza ´a el NDK y que ue a de so wa e lib e, ya que en la ac ualidad no exis e ninguno que cumpla es os dos equisi os. Exis en di e en es p o ocolos de comunicaci´on en e la aplicaci´on clien e y la aplicaci´on se ido . Es e p oyec o se ha desa ollado u ilizando el p o ocolo de comunicaci´on Remo e F ame Bu e (RFB), u ilizado po odos los clien es y se ido es VNC. De es a mane a la aplicaci´on se ´a compa ible con cualquie se ido VNC ins alado en cualquie e minal. An es de p o undiza m´as en c´omo se han a on ado los obje i os del p oyec o con- iene es ablece cie os conocimien os b´asicos ela i os al dominio de es as aplicaciones. Comenza emos explicando algunos concep os que se han u ilizado an es, ales como VNC, RFB, And oid, e c. 1.1. Concep os 1.1.1. Esc i o io emo o Un esc i o io emo o es una ecnolog´ıa que pe mi e a un usua io con ola desde un e minal g ´a ico (clien e) o o e minal g ´a ico (se ido ). X-Window ue el p ime esc i o- io emo o desa ollado po el Massachuse s Ins i u e o Technology (MIT) en la d´ecada de los ochen a [1]. 3 4Cap´ ı ulo 1. In oducci´ on 1.1.2. VNC VNC son las siglas en ingl´es de Vi ual Ne wo k Compu ing [2]. Es un sis ema de esc i o io emo o que u iliza el p o ocolo Remo e F ame Bu e (RFB) pa a con ola emo amen e o a m´aquina. Es ´a basado en una a qui ec u a clien e-se ido , donde la m´aquina con la aplicaci´on clien e es la que con ola a la m´aquina con la aplicaci´on se - ido . VNC ansmi e los e en os de a ´on y eclado desde el clien e al se ido y ´es e de uel e las ac ualizaciones de pan alla en la o a di ecci´on a a ´es de una ed de comu- nicaciones. VNC es independien e del sis ema ope a i o, es deci , un clien e VNC ejecu ado en una m´aquina Windows pod ´ıa con ola un se ido ejecu ado en una m´aquina Linux. En de ini i a, se pod ´ıa con ola cualquie sis ema ope a i o desde cualquie sis ema ope a i o siemp e que ambos sean compa ibles con VNC. 1.1.3. RFB RFB son las siglas en ingl´es de Remo e F ame Bu e . Es un p o ocolo de comunicaci´on pa a el acceso emo o a in e aces g ´a icas de usua io. Como abaja a ni el de amebu e es aplicable a odos los sis emas de en anas (X11, Windows, Macin osh). RFB es el p o ocolo usado en VNC [3]. 1.1.4. And oid And oid es un sis ema ope a i o basado en Linux, dise˜nado p incipalmen e pa a Sma p- hones y Table s. Inicialmen e ue desa ollado po And oid Inc, pe o inalmen e Google lo comp ´o en 2005. Fue p esen ado en 2007 jun o con la undaci´on Open Handse Alliance y el p ime m´o il con sis ema ope a i o And oid sali´o al me cado en 2008. La mayo ´ıa del c´odigo de And oid es ´a libe ado bajo una licencia Apache, licencia lib e y de c´odigo abie o. No obs an e no es ´a libe ado comple amen e, po lo an o no se puede deci que And oid sea un sis ema ope a i o lib e. Uno de sus pun os ue es es la acilidad pa a desa olla aplicaciones g acias a las he amien as que p opo ciona Google. Es as aplicaciones no malmen e es ´an esc i as en Ja a y se desa ollan u ilizando el And oid SDK, pe o ambi´en se pueden cons ui aplicaciones esc i as en C/C++ usando el And oid NDK [4]. 1.1.5. And oid SDK SDK son las siglas en ingl´es de So wa e De elopmen Ki . El SDK p opo cina las APIs y he amien as de desa ollo necesa ias pa a cons ui , es ea y depu a aplicaciones pa a And oid [5]. 1.1.6. And oid NDK NDK son las siglas en ingl´es de Na i e De elopmen Ki . El NDK es un conjun o de he amien as que pe mi en desa olla pa e de la aplicaci´on pa a And oid con lenguajes de c´odigo na i o como C o C++ [6]. 1.1. Concep os 5 1.1.7. JNI JNI son las siglas en ingl´es de Ja a Na i e In e ace. Es un amewo k de p og amaci´on que pe mi e a c´odigo Ja a llama y se llamado desde apliaciones na i as y lib e ias esc i as en o o lenguajes como pueden se C, C++ o ensamblado [7]. JNI p opo ciona odo lo necesa io pa a que la comunicaci´on en e el SDK y el NDK sea posible. G acias a ´el es posible cons ui aplicaciones en And oid u ilizando c´odigo na i o. 1.1.8. Tigh encoding Tigh es un ipo de codi icaci´on m´as compac ada, es muy e icien e y es ´a op imizado pa a conexiones con poco ancho de banda. Tigh incluye an o la e iciencia de comp esi´on sin p´e didas, como opcionales o mas de comp esi´on con pe didas pa a JPEG [8]. 1.1.9. ZRLE encoding ZRLE, es un ipo de codi icaci´on compac a y e icien e. Es ´a op imizado pa a conexiones con poco ancho de banda y u iliza la lib e ´ıa ZLib pa a comp imi los da os. 1.1.10. Gi Es un so wa e de con ol de e siones dise˜nado po Linux o als[9][10]. Se cen a en la elocidad y la e iciencia. Inicialmen e ue cons uido pa a el desa ollo del Ke nel de Linux pe o desde en onces cada ez m´as p oyec os lo han ido adop ando. 1.1.11. Wi eSha k Wi eSha k es un so wa e analizado de p o ocolo de ed (sni e ) licenciado bajo GPL 2 [11]. Es uno de los sni e m´as impo an es y comple os, en ´el con ibuyen ex- pe os en edes de odo el mundo. 1.1.12. F ee So wa e F ee So wa e del ingl´es so wa e lib e. Es el so wa e que pe mi e al usua io compa i , es udia y modi ica [12]. Todo so wa e lib e debe ga an iza las libe ades de usa el p og ama con cualquie p op´osi o, es udia y modi ica el p og ama, dis ibui copias del p og ama y, po ´ul imo, la libe ad de hace p´ublicas las modi icaciones que se hayan ealizado. 1.1.13. GPL GPL son las siglas en ingl´es de Gene al Public License [13]. Es una licencia de c´odigo lib e edac ada po la F ee So wa e Funda ion. El c´odigo bajo es a licencia es c´odigo lib e ya que es a licencia ga an iza las cua o libe ades de ´es e, que son: usa el p og ama con cualquie p op´osi o, es udia y modi ica el p og ama, dis ibui copias del p og ama y po ´ul imo la libe ad de hace p´ublicas las modi icaciones que se hayan ealizado. 6Cap´ ı ulo 1. In oducci´ on 1.2. Mo i aciones La mo i aci´on p incipal pa a la ealizaci´on de es e p oyec o e a el desa ollo de algo nue o. As´ı, jun o con nues o in e ´es po el desa ollo de aplicaciones And oid usando c´odigo na i o, nos dimos cuen a de que no exis ´ıa ninguna aplicaci´on de esc i o io emo o que usase es a ecnolog´ıa. La ealizaci´on de es e p oyec o supon´ıa un desa ´ıo de ca a a la in e conexi´on en e el c´odigo en C++ y Ja a ya que pa a ello ue necesa io ap ende a hace compilaciones c uzadas, a pa e de ambi´en ap ende a u iliza JNI. 1.3. Obje i os Los obje i os de es e p oyec o son p incipalmen e dos, el desa ollo de una aplicaci´on de esc i o io emo o pa a And oid usando el NDK y que dicha aplicaci´on en su o alidad sea so wa e lib e. El obje i o de ealiza la aplicaci´on no e a s´olo el hecho de cons ui una aplicaci´on que uncionase co ec amen e. La aplicaci´on en´ıa que se usable y e icien e. Es o ´ul imo lo hemos log ado, ya que g acias al uso de c´odigo na i o se ha conseguido que la aplica- ci´on, no s´olo sea e icien e si no que iene ni eles de e iciencia compa ables con los de la aplicaci´on o icial de los c eado es del p o ocolo. En cuan o a la usabilidad, la aplicaci´on p opo ciona muchas opciones como, po ejemplo, es ablece conexiones ci adas y en ia combinaciones de eclas. En cuan o al so wa e lib e, odo el c´odigo ha sido licenciado bajo una licencia GPL e si´on 3, po lo an o el so wa e de la aplicaci´on ga an iza las cua o libe ades que odo so wa e debe ene pa a se conside ado como al. Conside amos impo an e y po eso es ´a en es a secci´on de obje i os, el ca ´ac e lib e del so wa e, ya que el so wa e lib e supone un a ance muy impo an e con espec o al mundo del so wa e p i a i o, c eando una comunidad de usua ios y p og amado es que in e ac ´uan en e s´ı mejo ando el desa ollo del so wa e. Cap´ı ulo 2 Es ado del a e Como e e encias ac uales pa a ealiza es e p oyec o, y ob ene ideas de aplicaciones en ocadas en el mismo campo, se han u ilizado los siguien es clien es pa a And oid: 2.1. VNC Viewe (RealVNC) VNC Viewe (RealVNC)[14] pe enecien e a la compa˜n´ıa RealVNC. Inicialmen e VNC su gi´o en el Oli e i & O acle Resea ch Lab (ORL3), siendo desa ollado po T is an Richa dson (in en o ), Andy Ha e (di ec o del p oyec o), Quen in S an o d-F ase y James Wea he all. Unos a˜nos despu´es, a ios de es os desa ollado es c ea ´ıan RealVNC con la idea de segui con es e p oyec o so wa e. Al no se una aplicaci´on de c´odigo abie o, es di ´ıcil sabe el ipo de implemen aci´on que lle a a cabo. Posee una in e az g ´a ica muy usable y un endimien o ´op imo. Pa a el con ol del o denado u iliza la pan alla a modo de ouchpad, es o es, el mo imien os en la pan alla son los mo imien os que ha ´a el a ´on. Es o p opo ciona un manejo len o pe o ex ema- damen e p eciso. Po o o lado RealVNC no almacena las cons ase˜nas sino que p egun a al usua io po ella cuando conec a a un se ido que la equie a. Ha sido una de las aplicaciones de e e encia, an o po su in e az como po su ´op imo endimien o. Como ya se ha dicho con an e io idad es de c´odigo ce ado, as´ı que ue imposible abaja sob e ella. 7 8Cap´ ı ulo 2. Es ado del a e 2.2. And oid- nc- iewe (And oidVNC) And oid- nc- iewe (And oidVNC)[16] es un p og ama lib e y de c´odigo abie o de con ol emo o pa a disposi i os And oid. Es un p oyec o desa ollado a pa i de una ama inicial de o a aplicaci´on llamada igh VNC. Es a bajo licencia GPL 2 y iene un eposi o io ac i o en google h p://code.google.com/p/and oid- nc- iewe /. Posee una in e az g ´a ica pob e y una ges i´on de conexiones poco cla a. Pa a el con- ol emo o del o denado o ece una amplio abanico de posibilidades cub iendo cualquie posibilidad al espec o. En el apa ado de la segu idad And oidVNC almcena las con ase˜nas en la Base de Da os sin ci a siendo ulne able a a aques, Al se una aplicaci´on de so wa e lib e hemos podio e y ap ende mucho de su c´odigo y ha sido una de las aplicaciones de e e encia ya que o ece un endimien o muy bueno. Nos ue imposible abaja sob e ´el ya que es ´a cons uida o almen e sob e SDK y nues o obje i o es u iliza la po encia del NDK. 2.3. Mul iVNC Mul iVNC[15] es un p oyec o de so wa e lib e bajo licencia GPL 2, basado en and oid- nc- iewe y desa ollado po Ch is ian Beie . Incluye sopo e pa a a ias codi icaciones, as´ı como el uso de Ze ocon (Ze o Con igu a ion Ne wo king) pa a ayuda a c ea de o ma au om´a ica una ed IP sin necesidad de con igu aciones o se ido es especiales. Al igual que And oidVNC posee una in e az pob e y, aunque mejo , una ges i´on de conexiones no demasiado cla o. Pa a la ep esen aci´on u iliza acele aci´on po ha dwa e median e GPU. Respec o al con ol u iliza un sis ema simila a RealVNC. En el aspec o de las con ase˜na p esen a un uncionamien o semejan e a And oidVNC. Es a aplicaci´on ha enido una ele ancia meno en el p oyec o ya que no nos con enc´ıa su endimien o en m´o iles de baja gama, se ha usado pa a obse a como esol ´ıan cie os aspec os y como compa a i a de endimien o. Cap´ı ulo 3 En o no de desa ollo y banco de p uebas 3.1. En o no de desa ollo Todo el p oyec o ha sido desa ollado bajo el Sis ema ope a i o Linux Min Debian Edi ion 64 bi s, bajo las opciones de esc i o io an o Ma e como X ce. La p incipal he amien a de desa ollo u ilizada ha sido Eclipse Juno, con los en o - nos de desa ollo in eg ados an o pa a C/C++ como pa a Ja a, ya que el p oyec o ha necesi ado de es os lenguajes. JDK: e si´on 1.6 64 bi s. SDK: e si´on and oid-sdk- 21.1-linux. NDK: e si´on ac ual and oid-ndk- 8d, aunque a lo la go del p oyec o ue necesa io ac ualiza a es a e si´on m´as ecien e. And oid: e si´on m´ınima de desa ollo And oid 4.0 (API 14). Aunque en un inicio se op ´o po desa olla pa a And oid 2.3.3 (API 10) po ene mayo cuo a de me cado, nos dimos cuen a al i desa ollando que la 4.0 nos da ´ıa mayo es bene icios u u os. Gi : sis ema de con ol de e siones pa a el abajo en equipo. Egi : plugin de Eclipse usado pa a in e ac ua con el eposi o io p´ublico del p oyec o en e los dis in os in eg an es. Doxygen: plugin que gene a la documen aci´on del c´odigo inal, ya que conside amos m´as comple o que el ja adoc de se ie. ADT: And oid De elope s Tools e si´on 22.0.1, plugin de Eclipse pa a el desa ollo de aplicaciones And oid. LaTeX: he amien a usada pa a la composici´on del ex o de la memo ia. G acias es as he amien as hemos podido abaja sob e un en o no uni icado, ya que eclipse daba odas las posibilidades sin sali de ´el. Po un lado pe mi ´ıa esc ibi el c´odigo en Ja a y C/C++ desde la misma he amien a, as´ı mismo, pe mi ´ıa el desa ollo sob e And oid g acias al plugin ADT y la ges i´on del c´odigo median e Gi de una o ma sencilla g acias a Egi . 9 10 Cap´ ı ulo 3. En o no de desa ollo y banco de p uebas 3.2. Banco de p uebas Las p uebas de depu aci´on de la aplicaci´on se han ealizado en dos e minales m´o iles con dis in as esoluciones y especi icaciones gene ales pa a obse a el impac o an o en e minales de gama media/baja, como e minales de al a gama. Samsung Galaxy S3 con And oid 4.2.2 Jelly Bean. Samsung Galaxy Mini 2 con And oid 4.1.2 Jelly Bean. Como se ido es VNC se han usado: x11 nc, con codi icaci´on SSL y sin ella. RealVNC, con cla e y sin ella. Cap´ı ulo 4 Tecnolog´ıas allidas En es e apa ado se desc ibi ´an algunas de las ecnolog´ıas que se pensa on usa en un p incipio y que po un mo i o u o o al inal se desecha on. 4.1. Simple Di ec Media Laye Simple Di ec Media Laye [17][18], o m´as com´unmen e conocida po sus siglas SDL, es una lib e ´ıa desa ollada en C y licenciada y dis ibuida bajo licencia LGPL, p opo ciona una se ie de unciones pa a la ges i´on de dibujos e im´agenes en dos dimensiones. Esc i a o iginalmen e po Sam La inga. Du an e el p oceso de desa ollo del p oyec o, una de las ecnolog´ıas po las que se op a on ue SDL, dada las acilidades y po encia que o ec´ıa pa a el a amien o y ende- izado de la imagen. Sin emba go, du an e la inclusi´on del mismo en el p oyec o su gie on dos p oblemas que nos decidie on a abandona lo. El p ime mo i o ue que la ´unica e si´on con inuada y con sopo e pa a And oid e a SDL 2.0, la cual se encon aba en ase de desa ollo y las unciones p incipales pod´ıan cambia en mi ad del desa ollo. Exis ´ıa una e si´on no o icial y descon inuada de la mis- ma, que e a SDL 1.2, pe o en e los e o es conocidos es aban el uso del modo ´ıdeo, que e a esencial en el p oyec o, y dado que es aba descon inuado, nunca se hubie a a eglado. Po o o lado, el endimien o ob enido, una ez acoplado al p oyec o, ue muy pob e, llegando al caso de que el se ido expulsaba la conexi´on. Adem´as dado el uncionamien o de SDL, se dibujaba s´olo la pa e que se e´ıa de la pan alla, la usabilidad al mo e se po la misma, eniendo que edibuja con inuamen e la imagen, hizo in iable su uso. 11 18 Cap´ ı ulo 5. Tecnolog´ ıas usadas Reco ido del ec o : Aunque la ep esen aci´on de la in o maci´on es un ec o lineal, en ealidad el eco ido del mismo se ealiza como si de un ec o bidimensio- nal se a ase. De al o ma que pa a pasa de una ila a o a se ha ´ıa: Anchu a*bpp En cualquie caso, nos encon a ´ıamos con un eco ido del o den O(n2) (cos e cuad ´a ico). Pa a ecoge la in o maci´on de la imagen, se eco e el ec ´angulo que ha su ido cambios y se copia di ec amen e en el ec o inal. Pa a hace la copia se usa la unci´on de C memcpy, dada su e iciencia copiando bloques de by es. 5.2.3. Can as pa a la ep esen aci´on Pa a la ep esen aci´on de la imagen se ha usado Can as pa a And oid, usando sus unciones de dibujado de Bi map. Los dos m´e odos de Can as usados pa a dibuja el bi map son: d awBi map ( i n [ ] c olo s , i n o s e , i n s i de , in x , in y , in wid h , in heigh , boolean hasAlpha , Pain pain ) Median e es e m´e odo es posible dibuja un bi map a pa i de su in o maci´on de p´ıxeles, almacenada en colo s, se usa pa a ep esen a los da os de la imagen seg´un se modi ican. d awBi map ( Bi map bi map , Rec s c , Rec F ds , Pain pain ) Median e ´es e dibujamos un bi map, pas´andole el bi map ya c eado como pa ´ame o. Cada uno de los m´e odos an e io es es usado en dos si uaciones y con ex o dis in os, es necesa io usa ambos, como e emos m´as adelan e, pa a una ´op ima ep esen aci´on. Los dos con ex os dis in os a los que hace en e la aplicaci´on son: Es ado no mal: sucede siemp e que hay una ac ualizaci´on en la imagen y siemp e y cuando el usua io no se es ´e desplazando po la pan alla o haciendo zoom. En es e caso la imagen se ep esen a ´a median e su ec o de p´ıxeles. El usua io se mue e po la imagen o hace zoom: cuando el usua io se desplaza a a ´es de la imagen o hace zoom, es necesa io c ea un bi map con la in o maci´on ac ual de la imagen, ya que en caso con a io, ob end ´ıamos un p´esimo endimien o po dos mo i os: •Si us´asemos la ep esen aci´on a pa i de su in o maci´on de p´ıxeles, en cada p og esi´on po la imagen ha ´ıa al a edibuja la imagen, consiguiendo un mo- imien o o zoom len o. •Como es a ´ıamos con inuamen e edibujando la imagen, y adem´as, en cada ep esen aci´on And oid c ea ´ıa un bi map empo al, p o oca ´ıamos un al o consumo de CPU. 5.2. Aplicaci´ on 19 De al o ma, al c ea un bi map, el mo imien o po la imagen es luido. El ´unico pun o a conside a es la op imizaci´on de cuando c ea y des ui es e bi map, ya que la c eaci´on de bi maps es un p oceso pesado y que equie e de muchos ecu sos. As´ı pues los pun os en los que se des uye o se ma ca pa a des ui el bi map son: •Cuando el usua io haga click sob e la imagen, en es e pun o se conside a que el usua io in en a in e ac ua con el se ido , po lo an o, es necesa io des ui el bi map y man ene ac ualizada la imagen en odo momen o. •En el caso de que el usua io deje de mo e se po la pan alla, al menos, du an e medio segundo o deje de hace zoom. En es e caso es con enien e des ui la imagen en pos de consegui una imagen ac ualizada del se ido . El mo i o po el cual se espe a medio segundo, es con el in de no in e umpi el mo imien o del usua io, es deci , si se des uyese el bi map en el momen o que le an a el dedo de la pan alla, al ol e a mo e se se p oduci ´ıa una len i ud has a que se ol iese a c ea el nue o bi map. Adem´as as´ı, op imizamos la c eaci´on de bi map y educimos el uso de CPU. El p oblema que encon amos en e a o as soluciones, a la ho a de ac ualiza la imagen, es el hecho de que la pa e na i a (C++) ac ualiza los da os de la imagen di ec- amen e en el ec o , si po el con a io, odo se hubiese desa ollado en Ja a, se pod ´ıa habe ac ualizado la in o maci´on sob e un bi map ya c eado, de al o ma que se aho- a ´ıa el consumo de CPU de i ado de la c eaci´on, aunque se pe de ´ıa endimien o en la ac ualizaci´on. 20 Cap´ ı ulo 5. Tecnolog´ ıas usadas Cap´ı ulo 6 Especi icaciones En es e cap´ı ulo se desc ibe la cons ucci´on de la aplicaci´on. P ime o se expond ´an las especi icaciones de equisi os an o ex e nos, como uncionales. Despu´es en el siguien e apa ado se explica ´an los diag amas UML del c´odigo, jun o con explicaciones de odo el lujo del p og ama. 6.1. Especi icaci´on de equisi os Los equisi os de la aplicaci´on son: 6.1.1. In e aces ex e nos En es a secci´on se indican los equisi os ex e nos a la aplicaci´on. In e aces de usua io: La in e az de uso p opo ciona odo lo necesa io pa a con ola la aplicaci´on en su o alidad. In e aces de ha dwa e: Se debe dispone de un disposi i o m´o il y un o denado . In e aces de so wa e: La e si´on de And oid del disposi i o m´o il debe se la 4.0 o supe io . En la m´aquina emo a se debe dispone de una aplicaci´on VNC de ipo se ido . In e aces de comunicaci´on: Tan o el clien e como el se ido deben dispone de una conexi´on a In e ne o es a ambos en la misma ed local. 21 22 Cap´ ı ulo 6. Especi icaciones 6.1.2. Funciones Los siguien es equisi os uncionales de inen las acciones que deben ene luga en el so wa e p ocesando las en adas y gene ando las salidas. C ea conexi´on: P io idad: Al a. Es abilidad: Al a. Desc ipci´on: C ea una nue a conexi´on y la a˜nade a la lis a de conexiones. En ada: Nomb e de la conexi´on, IP, pue o, con ase˜na y calidad de imagen. Salida: La conexi´on se a˜nade a la lis a y se conec a. O igen: Usua io. Des ino: Aplicaci´on. Necesi a: Acceso a la Base de Da os. Acci´on: C ea una nue a conexi´on. P econdici´on: Nomb e de conexi´on no epe ida, IP ´alida y pue o en un ango ´alido. Pos condici´on: La conexi´on se a˜nade a la lis a de conexiones. E ec os la e ales: N/A. Edi a conexi´on: P io idad: Media. Es abilidad: Al a. Desc ipci´on: Se edi an los da os de una de e minada conexi´on. En ada: Nomb e de la conexi´on, IP, pue o, con ase˜na y calidad de imagen. Salida: La conexi´on con los da os modi icados. O igen: Usua io. Des ino: Aplicaci´on. Necesi a: Acceso a la Base de Da os. Acci´on: Edi a los da os de una conexi´on. P econdici´on: IP ´alida y pue o en un ango ´alido. Pos condici´on: Los da os de la conexi´on se modi ican. E ec os la e ales: N/A. 6.1. Especi icaci´ on de equisi os 23 Bo a conexi´on: P io idad: Media. Es abilidad: Al a. Desc ipci´on: Se elimina una conexi´on. En ada: E en o usua io. Salida: La conexi´on se elimina de la aplicaci´on. O igen: Usua io. Des ino: Aplicaci´on. Necesi a: Acceso a la Base de Da os. Acci´on: Elimina una conexi´on. P econdici´on: N/A. Pos condici´on: La conexi´on se bo a de la aplicaci´on. E ec os la e ales: Si la conexi´on es ´a en a o i os se bo a ´a ambi´en ah´ı. Ve in o maci´on de la conexi´on: P io idad: Baja. Es abilidad: Al a. Desc ipci´on: Mues a la in o maci´on de una conexi´on. En ada: E en o usua io. Salida: Los da os de la conexi´on. O igen: Usua io. Des ino: Usua io. Necesi a: Acceso a la Base de Da os. Acci´on: Mues a los da os de una conexi´on. P econdici´on: N/A Pos condici´on: Se mues an los da os de una conexi´on. E ec os la e ales: N/A. 24 Cap´ ı ulo 6. Especi icaciones A˜nadi conexi´on a a o i os: P io idad: Baja. Es abilidad: Al a. Desc ipci´on: A˜nade una conexi´on a la lis a de a o i os del usua io. En ada: E en o usua io. Salida: La conexi´on se a˜nade a la lis a de a o i os. O igen: Usua io. Des ino: Aplicaci´on. Necesi a: Acceso a la base de da os. Acci´on: A˜nade la conexi´on a la lis a de a o i os. P econdici´on: N/A. Pos condici´on: La conexi´on se a˜nade a a o i os. E ec os la e ales: N/A. Bo a conexi´on de a o i os: P io idad: Baja. Es abilidad: Al a. Desc ipci´on: Bo a una conexi´on de la lis a de a o i os. En ada: E en o usua io. Salida: La conexi´on se elimina de a o i os. O igen: Usua io. Des ino: Aplicaci´on. Necesi a: Acceso a la base de da os. Acci´on: Elimina una conexi´on de la lis a de a o i os. P econdici´on: N/A. Pos condici´on: La conexi´on se bo a de a o i os. E ec os la e ales: N/A. 6.1. Especi icaci´ on de equisi os 25 Ve lis a de conexiones: P io idad: Al a. Es abilidad: Al a. Desc ipci´on: Se mues an odas las conexiones ecien es. En ada: E en o usua io. Salida: La lis a de conexiones ecien es. O igen: Usua io. Des ino: Usua io. Necesi a: Acceso a la base de da os. Acci´on: Se mues an las conexiones ecien es. P econdici´on: N/A Pos condici´on: Se mues a la lis a de conexiones ecien es. E ec os la e ales: N/A. Ve lis a de conexiones a o i as: P io idad: Baja. Es abilidad: Al a. Desc ipci´on: Se mues an odas las conexiones a o i as. En ada: E en o usua io. Salida: La lis a de conexiones a o i as. O igen: Usua io. Des ino: Usua io. Necesi a: Acceso a la base de da os. Acci´on: Se mues an las conexiones a o i as. P econdici´on: N/A Pos condici´on: Se mues a la lis a de conexiones a o i as. E ec os la e ales: N/A. 26 Cap´ ı ulo 6. Especi icaciones Ab i men´u p incipal: P io idad: Baja. Es abilidad: Al a. Desc ipci´on: Se ab e el men´u p incipal. En ada: E en o usua io. Salida: Se mues a el men´u. O igen: Usua io. Des ino: Usua io. Necesi a: N/A. Acci´on: Se mues a el men´u p incipal. P econdici´on: N/A Pos condici´on: Se mues a el men´u p incipal. E ec os la e ales: N/A Conec a se: P io idad: Al a. Es abilidad: Al a. Desc ipci´on: Se conec a al se ido especi icado en los da os de la conexi´on. En ada: Da os de la conexi´on y e en o usua io. Salida: Conexi´on con el se ido . O igen: Usua io. Des ino: Usua io. Necesi a: N/A. Acci´on: Se conec a con el se ido emo o. P econdici´on: El se ido iene que ene ejecu ´andose una aplicaci´on VNC. Pos condici´on: El clien e se conec a con el se ido . E ec os la e ales: N/A. 6.1. Especi icaci´ on de equisi os 27 Desconec a se: P io idad: Al a. Es abilidad: Al a. Desc ipci´on: Se desconec a del se ido al que se es aba conec ado. En ada: E en o usua io o desconexi´on del se ido Salida: Desconexi´on con el se ido . O igen: Usua io o se ido . Des ino: Usua io. Necesi a: Es a conec ado. Acci´on: Se desconec a del se ido emo o. P econdici´on: Se debe es a conec ado pa a pode desconec a se. Pos condici´on: El clien e se desconec a del se ido . E ec os la e ales: N/A. Hace click: P io idad: Al a. Es abilidad: Al a. Desc ipci´on: Se en ´ıa la o den de pulsa el bo ´on izquie do del a ´on. En ada: E en o usua io. Salida: N/A. O igen: Usua io. Des ino: Aplicaci´on. Necesi a: Es a conec ado. Acci´on: Se en ´ıa la o den de hace click. P econdici´on: Se debe es a conec ado. Pos condici´on: Se en ´ıa la o den de hace click. E ec os la e ales: N/A. 34 Cap´ ı ulo 6. Especi icaciones es. a u eam. ncpp.con olle .Lis F agmen Tab + Lis F agmen Tab() + onC ea eView(infla e : Layou Infla e , con aine : ViewG oup, sa edIns anceS a e : Bundle) : View + onS a () + onLis I emClick(lis View : Lis View, iew : View, posi ion : in , id : long) + dele eUse () + edi ingUse () + e eshFa o i es(use : es. a u eam. ncpp.model.sql.Connec ion) + ge O() : Objec + se O(o : Objec ) + ge Use Lis () : A ayLis <Connec ion> + se Use Lis (use Lis : A ayLis <Connec ion>) es. a u eam. ncpp.con olle .Lis F agmen TabFa + Lis F agmen TabFa () + onC ea eView(infla e : Layou Infla e , con aine : ViewG oup, sa edIns anceS a e : Bundle) : View + onS a () + onLis I emClick(lis View : Lis View, iew : View, posi ion : in , id : long) + dele eUse () + edi ingUse () + ge O() : Objec + se O(o : Objec ) + ge Use Lis () : A ayLis <Connec ion> + se Use Lis (use Lis : A ayLis <Connec ion>) es. a u eam. ncpp. iew.Adap e + Adap e (ac : Ac i i y, u : A ayLis <Connec ion>) + ge Coun () : in + ge I em(posi ion : in ) : Objec + ge I emId(posi ion : in ) : long + ge View(posi ion : in , con e View : View, pa en : ViewG oup) : View + dele eRow( ow : es. a u eam. ncpp.model.sql.Connec ion) + ge Lis () : A ayLis <Connec ion> + se Lis (lis : A ayLis <Connec ion>) es. a u eam. ncpp. iew.DialogOp ions + newIns ance(lis ene : Supe Lis ene ) : DialogOp ions + onC ea eDialog(sa edIns anceS a e : Bundle) : Dialog -adap e -adap e Diag am: lis asUML Page 1 Figu a 6.3: Diag ama Lis as de Conexiones Las clases Lis F agmen Tab y Lis F agmen TabFa (Ve Figu a 6.3) son las enca ga- das de mos a las lis as de conexiones y conexiones a o i as espec i amen e. La clase SlideLis F agmen (Ve Figu a 6.4) se enca ga de cons ui el men´u la e al y es llamada desde Can asAc i i y. Can asAc i i y (Ve Figu a 6.4) es la enca gada de cap u a odos los e en os que se p oduzcan en el clien e, mos a la imagen del esc i o io y comunica se con la pa e na i a. Pa a dibuja la imagen se apoya en la clase Can asView (Ve Figu a 6.4). Pa a Comuni- ca se con la pa e na i a se apoya en VncB idgeJNI (Ve imagen 6.5). La comunicaci´on en e el VncB idgeJNI y el Can as Ac i i y se ealiza median e el pa ´on obse e (Ve igu a 6.4 y 6.5). 6.2. Diag amas de clases 35 es. a u eam. ncpp.model.Obse ableCan as + Obse ableCan as() + addObse e (obse e : Obse e Can as) + no i yIniF ame(da a : in [], offse : in , x : in , y : in , wid h : in , heigh : in , ealWid h : in , ealHeigh : in ) + no i yRed aw(x : in , y : in , wid h : in , heigh : in ) + no i yFinish() es. a u eam. ncpp. iew.Can asView + Can asView(con ex : Con ex , a s : A ibu eSe ) + ge RealHeigh () : in + ge RealWid h() : in + ge Scale() : floa + se Scale(scale : floa , scaleX : floa , scaleY : floa ) + s a D ag() + endD ag() + eD aw() + ini Can as(da a : in [], offse : in , s ide : in , x : in , y : in , wid h : in , heigh : in ) es. a u eam. ncpp. iew.SlideLis F agmen + onC ea eView(infla e : Layou Infla e , con aine : ViewG oup, sa edIns anceS a e : Bundle) : View + onAc i i yC ea ed(sa edIns anceS a e : Bundle) + onLis I emClick(lis View : Lis View, iew : View, posi ion : in , id : long) es. a u eam. ncpp.con olle .Can asAc i i y + onConfigu a ionChanged(newConfig : Configu a ion) + onMenuI emSelec ed( ea u eId : in , i em : MenuI em) : boolean + onKeyDown(keyCode : in , e : KeyE en ) : boolean + dispa chKeyE en (e en : KeyE en ) : boolean + onKeyUp(keyCode : in , e : KeyE en ) : boolean + onTouchE en (e en : Mo ionE en ) : boolean + onUpMouse(e : Mo ionE en ) : boolean + upda eRed aw(x : in , y : in , wid h : in , heigh : in ) + upda eIniF ame(da a : in [], offse : in , x : in , y : in , wid h : in , heigh : in , ealWid h : in , ealHeigh : in ) + upda eFinish() + showKeyboa d() + sendTex Dialog() : Dialog + passwo dNeededDialog() : Dialog + c ea eSe e No FoundDialog() : Dialog + exi Dialog() : Dialog + se e In e up ConexionDialog() : Dialog + imeExceededDialog() : Dialog + comboE en sDialog() : Dialog + unc ionKeysDialog() : Dialog + openHelpDialog() : Dialog + cen e ImageCan as() «in e ace» es. a u eam. ncpp.model.Obse e Can as + upda eIniF ame(da a : in [], offse : in , x : in , y : in , wid h : in , heigh : in , ealWid h : in , ealHeigh : in ) + upda eRed aw(x : in , y : in , wid h : in , heigh : in ) + upda eFinish() -obse e -can as Diag am: Can as Page 1 Figu a 6.4: Diag ama Can as La ep esen aci´on de la imagen se ha ealizado con can as, en la clase Can asView (Ve Figu a 6.4). Pa a da mejo sensaci´on de luidez a la ho a de mo e se po la imagen se u iliza un Bi map auxilia en luga de siemp e el mismo. Cuando el p og ama en a en modo d ag, se c ea el Bi map auxilia y se inicializa con el alo ac ual de la imagen. Si el usua io es ´a mo iendose po la imagen (modo d ag) el m´e odo onD aw de can as mos a ´a el Bi map auxilia . i ( ! d ag ){ can as . d awBi map ( da a , o s e , s i de , x , y , wid h , heigh , a l s e , n u ll ) ; } e l s e { can as . d awBi map ( bi map , bi mapRec , bi mapRec , null ) ; } 36 Cap´ ı ulo 6. Especi icaciones En el momen o que el usua io deja de mo e se sal a un ime c eado en un hilo apa e, de al mane a que du an e 0.5 segundos la imagen no se des uye (Ve secci´on 5.2.3). La ac ualizaci´on de la imagen nos llega desde el c´odigo na i o (Ve secci´on 6.2.2). Cuando llega una no i icaci´on desde C++ de que la imagen ha sido modi icada, el can as se in alida y se edibuja. Si Can asAc i i y de ec a un e en o de Sc oll (mo imien o po la pan alla), se llama al m´e odo doSc oll. Es e m´e odo calcula cuan os p´ıxeles se ha mo ido en los ejes X e Y, comp obando que no se salga de la imagen. Una ez calculados se llama al m´e odo de can as sc ollTo pa a que modi ique la imagen. i (mo eX != 0 | | mo eY != 0){ ealX = ealX + ( i n )mo eX ; ealY = ealY + ( i n )mo eY can as . sc oll To (( i n )( ealX ∗scale Fac o ) , ( i n ) ( ealY ∗scaleFac o ) ) ; } Si Can asAc i i y de ec a un e en o de Scale (zoom), se ecalcula el ac o de escala y dependiendo de si ha sido posi i o o nega i o se llama a, el m´e odo sc ollTo de can as di ec amen e o a el m´e odo doSc oll. i ( isDo ){ i ( a c o >1){ in mo eX = ( i n )( x∗scal eF ac o ) ; in mo eY = ( i n )( y∗scal eF ac o ) ; i (x <0){ mo eX = 0 ; y = 0; } i (y <0){ mo eY = 0 ; y = 0; } ealX = ( in )x ; ealY = ( in )y ; can as . sc ol l To (mo eX , mo eY ) ; }e l s e i ( ac o <1 ){ in auxX = 0; in auxY = 0; i (x ∗scaleFac o >can as . ge RealWid h ( ) ) { auxX = −100; }e l s e { auxX = −10; } i (y ∗scaleFac o >can as . ge RealHeigh ( ) ){ auxY = −100; }e l s e { auxY = −10; } 6.2. Diag amas de clases 37 doS c oll (auxX , auxY ) ; } } VncB idgeJNI es la clase que p opo cina los m´e odos pa a comunica se con la pa e na i a. Es capaz de llama a unciones na i as ales como iniConnec , mouseE en , keyE- en , e c., de es a mane a se es ablece la comunicaci´on de Ja a a C/C++ (Ve secci´on 5.2.2). Las no i icaciones llegan desde el c´odigo na i o a a ´es de la in e az Obse e JNI. es. a u eam. ncpp.model.Obse ableCan as + Obse ableCan as() + addObse e (obse e : Obse e Can as) + no i yIniF ame(da a : in [], offse : in , x : in , y : in , wid h : in , heigh : in , ealWid h : in , ealHeigh : in ) + no i yRed aw(x : in , y : in , wid h : in , heigh : in ) + no i yFinish() «in e ace» es. a u eam. ncpp.model.Obse e Can as + upda eIniF ame(da a : in [], offse : in , x : in , y : in , wid h : in , heigh : in , ealWid h : in , ealHeigh : in ) + upda eRed aw(x : in , y : in , wid h : in , heigh : in ) + upda eFinish() es. a u eam. ncpp.model.VncB idgeJNI + VncB idgeJNI() + s a Connec (hos : S ing, po : in , pass : S ing, quali y : S ing, wifi : boolean, hideMouse : boolean) : Connec ionE o + finishVnc() + upda eFinishConnec ion() + upda eIniF ame(wid h : in , heigh : in , bpp : in , dep h : in ) + upda eReD aw(x : in , y : in , wid h : in , heigh : in ) + sendMouseE en (x : in , y : in , e en : MouseE en ) + sendKey(key : in , down : boolean) es. a u eam. ncpp.model.Sc een + Sc een(wid h : in , heigh : in , bpp : in ) + c ea eDa a() + ge Wid h() : in + se Wid h(wid h : in ) + ge Heigh () : in + se Heigh (heigh : in ) + ge Bpp() : in + se Bpp(bpp : in ) + ge Da a() : in [] + add(pos : in , alue : in ) «in e ace» es. a u eam. ncpp.model.Obse e JNI + upda eFinishConnec ion() + upda eIniF ame(wid h : in , heigh : in , bpp : in , dep h : in ) + upda eReD aw(x : in , y : in , wid h : in , heigh : in ) -sc een -obse e Diag am: model Page 1 Figu a 6.5: Diag ama Modelo 6.2.2. Pa e esc i a en C/C++ Aho a amos a desc ibi el c´odigo esc i o en C/C++. La clase Ja a VncB idgeJNI ealiza las llamadas a la pa e na i a a a ´es de las unciones implemen adas en el iche o Ja aB idge.cpp. Es e iche o no se mues a en el diag ama de clases pues o que no es una clase, a´un as´ı, su ´unica unci´on es hace las llamadas p opias a la clase Vnc, en o as palab as ac ´ua como puen e de Ja a a C++. 38 Cap´ ı ulo 6. Especi icaciones Obse ableJNI + Obse ableJNI() + ~ Obse ableJNI() + addObse e (obse e : jobjec , en : JNIEn *) + no i yIniF ame(wid h : in , heigh : in , bpp : in , dep h : in ) + no i yReD aw() + no i yFinishConnec ion() + finishByClien () + ge Bi mapDa a() + ge A ayElemen s() : jin * + se A ayElemen s(in o : jin *) Handle RFB + Handle RFB() + ~Handle RFB() + se Sc een(sc een : Clien Sc een*) + iniF ameBuffe (clien _sc een : bClien *) + upda eSc een(clien : bClien *, x : in , y : in , w : in , h : in ) + finishConnec ion() + finishClien () + se Pass(aux_pass : cha *) + ge Pass(clien : bClien *) : cha * + eePass() Vnc + Vnc() + ~ Vnc() + iniConnec ion(hos : cha *, po : in , pass : cha *, quali y : in , comp ess : in , hide_mouse : bool) : Connec ionE o + closeConnec ion() + addObse e (obse e : jobjec , en : JNIEn *) + sendMouseE en (x : in , y : in , e en : MouseE en ) : bool + sendKeyE en (key : in , down : bool) : bool Clien Connec ionRFB + Clien Connec ionRFB() + ~Clien Connec ionRFB() + iniConnec ion(hos : cha *, po : in , pass : cha *, pic u e_quali y : in , comp ess : in , hide_mouse : bool) : Connec ionE o + cleanRFB() + sendMouseE en (x : in , y : in , e en : MouseE en ) : bool + sendKeyE en (key : in , down : bool) : bool + s opConnec ion() Clien Sc een + Clien Sc een() + ~Clien Sc een() + doMask(clien : bClien *) + iniSc een(wid h : in , heigh : in , bi sPe Pixel : in ) : in + upda eSc een( ameBuffe : uin 8_ *, x : in , y : in , w : in , h : in ) es. a u eam. ncpp.model.VncB idgeJNI + VncB idgeJNI() + s a Connec (hos : S ing, po : in , pass : S ing, quali y : S ing, wifi : boolean, hideMouse : boolean) : Connec ionE o + finishVnc() + upda eFinishConnec ion() + upda eIniF ame(wid h : in , heigh : in , bpp : in , dep h : in ) + upda eReD aw(x : in , y : in , wid h : in , heigh : in ) + sendMouseE en (x : in , y : in , e en : MouseE en ) + sendKey(key : in , down : boolean) b 1 0..1- b sc een 1 1 sc een 11 Diag am: connec ion Page 1 Figu a 6.6: Diag ama Conexi´on Al inicializa el c´odigo na i o se c ea la clase Vnc (Ve Figu a 6.6) y se a˜nade el ob- se e a la clase Clien Sc een pa a que ´es e pueda ealiza las no i icaciones a Ja a. En la cons uc o a de Vnc se c ean las clases Clien Sc een, Clien Connec ionRFB y se le pasa a la clase Handle RFB la e e encia a Clien Sc een pa a que ´es a pueda comunica se con ella. Vnc e asmi i ´a odas las o denes que le lleguen de Ja aB idge a Clien Connec ionRFB. La clase Clien Connec ionRFB (Ve Figu a 6.6) es la enca gada de ges iona la cone- xi´on en e el clien e y el se ido u ilizando el p o ocolo RFB. Pa a es ablece una conexi´on lo p ime o que se hace es inicializa la es uc u a bClien , en es e pun o se indica cual es el hos , el pue o, la calidad de imagen, e c. Un pun o muy impo an e de la iniciali- zaci´on es indica cuales son las unciones que se han de llama cuando el se e mande no i icaciones. Pa a ello nos apoyamos en la clase Handle RFB, de al mane a que, po ejemplo, cuando llega un upda e de la imagen indicamos que iene que llama al m´e odo upda eSc een del handle . clien RFB= bGe Clien ( bi sPe Sample , samplesPe Pixel , by esPe Pixel ) ; clien RFB−>se e Po = po ; clien RFB−>se e Hos = hos ; clien RFB−>p og amName = ”VNC++”; 6.2. Diag amas de clases 39 Handle RFB : : se Pass ( pass ) ; clien RFB−>Ge Passwo d = Handle RFB : : ge Pass ; clien RFB−>appDa a . q uali y Le e l = p i c u e q u a l i y ; clien RFB−>appDa a . comp essLe el = comp ess ; clien RFB−>appDa a . useRemo eCu so = hide mouse ; clien RFB−>MallocF ameBu e =Handle RFB : : iniF ameBu e ; clien RFB−>canHandleNewFBSize = TRUE; clien RFB−>Go F ameBu e Upda e=Handle RFB : : upda eSc een ; clien RFB−>FinishedF ameBu e Upda e= Handle RFB : : inishUpda e ; clien RFB−>l i s e n P o = LISTEN PORT OFFSET; clien RFB−>l i s e n 6 P o = LISTEN PORT OFFSET; Una ez e minada la inicializaci´on de bClien se p ocede a la conexi´on con el se ido . i ( ! b I n i C l i e n ( clien RFB ,0 ,NULL)){ e o c onn ec = NoSe e Found ; i (DEBUG) LOGE(”No se e ound ” ) ; clien RFB = NULL; } e l s e i ( ! clien RFB−> ameBu e ){ i (DEBUG) LOGE(”No F ame Found ” ) ; e o c onn ec = NoF ameFound ; cleanR b (); } Si odo a bien se c ea un hilo pa a maneja los e en os del p o ocolo RFB. Dicho hilo es un bucle in ini o a la espe a de mensajes que p o engan del se ido . while ( ! aux his −>s op connec ion ) { mes=Wai Fo Message ( aux his −>clien RFB , imeWai ) ; i (mes<0){ aux his−>s op connec ion = ue ; se e Ou = ue ; } i (mes){ i ( ! HandleRFBSe e Message ( aux his −>clien RFB )){ aux his−>s op connec ion = ue ; se e Ou = ue ; } } } La a iable aux his es un pun e o a Clien Connec ionRFB. Si no se ha pa ado la conexi´on se espe a has a que llega un mensaje del se ido , la unci´on enca gada de ello es Wai Fo Message. Despu´es la unci´on Handle RFBSe e Message es la enca gada de comp oba cual es el mensaje que ha llegado y en unci´on de ello, llama a unas unciones u o as de Handle RFB. Pa a en ia los e en os del a ´on o de pulsaci´on de eclas se u ilizan las unciones SendPoin e E en ySendKeyE en espec i amen e. Cabe des aca que pa a en ia el 40 Cap´ ı ulo 6. Especi icaciones e en o de pulsaci´on de eclado hay que ans o ma el c´odigo de ecla que nos llega desde Ja a pa a que el se e sea capaz de in e p e a lo co ec amen e. bool Clien Connec ionRFB : : sendKeyE en ( in key , bool down){ bKeySym bKey = ans o mToR bKey ( key ) ; i ( bKey != 0){ SendKeyE en ( clien RFB , bKey , down ) ; } } La clase Handle RFB (Ve Figu a 6.6) es una clase comple amen e es ´a ica. Es o se debe a que, dado que LibVNCSe e se encuen a esc i a en C y los e en os del mismo son pun e os a unciones, si no uesen es ´a icos los m´e odos en C++ ienen de o ma impl´ıci a el pa ´ame o his, que es una e e encia a la p opia clase. Po el con a io C no es un lenguaje o ien ado a obje os, po ello ese pa ame o his no exis e en las llamadas. Al decla a es ´a icos los m´e odos, el pa ´ame o his desapa ece. Sus m´e odos b´asicamen e edi igen la llama a las unciones de Clien Sc een, po eso e a necesa io pasa la e e encia al inicio. Clien Sc een (Ve Figu a 6.6) se enca ga del manejo de las ac ualizaciones de la ima- gen, as´ı como de comunica odos los cambios a Ja a. Es a comunicaci´on la hace a a ´es de Obse ableJNI median e la he encia de sus m´e odos. Cuando llega un e en o de inicializa la imagen desde el handle se llama al m´e odo iniSc een. En es e m´e odo se inicializan odos los alo es de la imagen y se en ´ıa una no i icaci´on a Ja a. in Clien Sc een : : in iSc e e n ( cons i n wid h , cons i n heigh , cons i n bi s Pe P ixe l ) { i (DEBUG) LOGE(” JNI iniF ameBu e ” ) ; his −>wid h=wid h ; his −>heigh =heigh ; // se pasa de b i s a by e his −>by esPe Pixel=bi sPe Pixe l /8; his −>dep h = bi sPe Pixel ; // se c a l c u l a e l e s pac io o a l d el b u e his −>s i z e = his −>heigh ∗ his −>wid h∗ his −>by esPe Pixel ; i (DEBUG) LOGE(”FIN JNI iniF ameBu e ” ) ; no i yIniF ame( his−>wid h , his −>heigh , his −>by esPe Pixel , his −>dep h ) ; e u n s i z e ; } Cuando se quie e in oca m´e odos de Ja a, pa a no i ica cambios, es necesa io colo- ca se en el en o no de ejecuci´on ac ual, es o es, en el hilo. Pa a ello usamos la unci´on ge En i omen . Es e m´e odo comp ueba si la a iable en , del ipo JNIEn *, se encuen a apun ando al hilo ac ual, si no uese el caso, se coloca en ´el. 6.2. Diag amas de clases 41 oid Obse ableJNI : : ge En i omen (){ in ge En = m−>Ge En ( ( oid ∗∗)&en , JNI VERSION 1 6 ) ; i ( ge En == JNI EDETACHED){ m−>A achCu en Th ead(&en ,NULL) ; } } El m´e odo no i yIniF ame ob iene el m´e odo upda eIniF ame del en o no Ja a y lo llama pas´andole la in o maci´on nue a. Despu´es se llama a Ge Objec Class pa a ob ene la clase VncB idgeJNI y as´ı, pode hace llamadas a sus m´e odos. Pa a hace una llamada a un m´e odo de Ja a, una ez enemos la clase, hay que u iliza el m´e odo Ge Me hodID pa a ob ene el ID del m´e odo que deseamos in oca . Una ez que dispongamos de dicha ID podemos llama lo usando CallVoidMe hod. oid Obse ableJNI : : no i yIniF ame ( i n wid h , in heigh , in bpp , in dep h ){ ge En i omen ( ) ; i (DEBUG) LOGE(” Take me hod iniF ame ” ) ; o b s e e c l a s s = en −>Ge Objec Class( his−>obse e objec ); // cogemos e l ID jme hodID upda eSc een = en −>Ge Me hodID ( o b s e e c l a s s , ”upda eIniF ame”, ”( I I I I )V” ) ; i (DEBUG) LOGE(” Launch me hod iniF ame ” ) ; en −>CallVoidMe hod ( obse e objec , upda eSc een , wid h , heigh , bpp , dep h ) ; i (DEBUG) LOGE(” Finish launch me hod iniF ame ” ) ; en −>Dele eLocalRe ( o b s e e c l a s s ) ; } Pa a inaliza , el m´e odo upda eSc een de Clien Sc een es el enca gado de ac ualiza una po ci´on de la imagen. El inicio de la po ci´on a ac ualiza iene indicado po los pa ´ame os x e y, siendo w y h la anchu a y la al u a espec i amen e de dicha po ci´on. oid Clien Sc een : : upda eSc een ( u in 8 ∗ ameBu e , cons i n x , cons i n y , cons i n w, cons i n h){ i (DEBUG) LOGE(” JNI Upda e ” ) ; i n p i x e l ; 42 Cap´ ı ulo 6. Especi icaciones in pos ; in pos co l ; in pos a ay ; ge Bi mapDa a (); j i n ∗i n o = ge A ayElemen s ( ) ; in e a l i , e a l j ; o ( i n i =0; i <w; i++ ){ e a l i = i + x ; pos co l = ( e a l i ∗by esPe Pixel ); o ( i n j =0; j<h ; j++){ e a l j = j + y ; pos = (( by esPe Pixel∗wid h ) ∗ e a l j ) + pos col ; memcpy(&pixel ,& ameBu e [ pos ] , by esPe Pixel ) ; pos a ay = ( wid h ∗ e a l j ) + e a l i ; i n o [ po s a ay ] = p i x e l ; } } i (DEBUG) LOGE(” JNI no i y eD aw ” ) ; se A ayElemen s ( i n o ) ; } Lo que hace es e m´e odo es eco e la po ci´on que ha cambiado con los dos bucles o . Las a iables eal i y eal j son las posiciones eales de la po ci´on den o de la imagen. Como la imagen se ep esen a en un bu e unidimensional es necesa io calcula el desplazamien o que se ob iene: pos = ((by esP e P ixel)(wid h))( eal j) + (( eal i)(by esP e P ixel)) Una ez enemos la posici´on copiamos el p´ıxel con memcpy y lo gua damos en in o. El bi map in o es una e e encia al bi map de Ja a, lo ob enemos a a ´es de los m´e odos ge Bi mapDa a yge A ayElemen s, de al mane a que cuando se modi ican elemen os de dicho bi map en C se es ´an modi icando en Ja a. Lo ´unico que al a po hace es ac ualiza la in o maci´on a a ´es del m´e odo se A ayElemen s. Median e el que JNIEn libe a el ec o del en o no de C/C++ con la unci´on ReleaseIn A ayElemen s y se ac ualiza el ec o de Ja a. Cap´ı ulo 7 Compa a i as Se desc ibe la compa aci´on del esula do inal con las aplicaciones que han sido omadas como e e encia en el p incipio del p oyec o. Como ya se indic´o en el cap´ı ulo dos, usamos como pun o de pa ida es aplicaciones que aba can el campo del con ol emo o m´o il. 7.1. Funcionalidad Nues o p op´osi o inicial e a mejo a cie os aspec os de es as aplicaciones ya exis en- es, y en es e apa ado obse amos esul ados. 7.1.1. Funcionalidades des acadas compa idas con VNC++ Hace zoom. Mues a el eclado. Esc ibe. En ´ıa secuencias de eclas. Recue da conexiones p e ias. 7.1.2. Funcionalidades di e en es espec o VNC++ RealVNC: como ya se ma iz´o, es a aplicaci´on es ´a basada en so wa e p i a i o, po lo que no disponemos de mucha in o maci´on ela i a a la implemen aci´on in e - na de es e p oyec o. Pe o algo que nos p opusimos desde el p incipio e a c ea un so wa e pu amen e lib e ya que pensamos que es as´ı como se llega a un p oduc o inal con m´as opciones de desa ollo y uso u u o. Pe mi e, a a ´es de un men´u de opciones, desac i a el modo de pan alla comple a, as´ı como opci´on de Copy&pas e. Tambi´en es des acable la di e encia en el manejo, en VNC Viewe al mo e el dedo po la pan alla lo que mo e emos es el cu so y no la imagen como en nues o caso. Mul iVNC: lib e y de c´odigo abie o, usa acele aci´on ha dwa e OpenGL pa a el dibujado y el zoom, mien as que en nues o caso se ha op ado po el uso de Can as. El manejo en la pan alla de Mul iVNC es igual que el de RealVNC. 43 50 Cap´ ı ulo 7. Compa a i as Mul iVNC: Figu a 7.8: Rendimien o 3G Mul iVNC Como se puede obse a los alo es con una conexi´on 3G son muy pa ecidos, ello es debido a c´omo unciona la p opia conexi´on y sus limi aciones. As´ı pues se puede conclui que el endimien o en en o nos de 3G de las aplicaciones es equi alen e. Cap´ı ulo 8 Conclusiones 8.1. Conclusiones Como conclusi´on pensamos que se han alcanzado las me as p opues as en el apa ado 1.3. Todo el c´odigo ha sido licenciado bajo una licencia lib e (GPL e si´on 3), po an o el obje i o de c ea una aplicaci´on de so wa e lib e se ha cumplido sin mayo p oblema. En cuan o al obje i o m´as impo an e, la cons ucci´on de la aplicaci´on de esc i o io emo o en And oid u ilizando c´odigo na i o, ambi´en se ha cumplido, ya que no s´olo se ha cons uido una aplicaci´on con muchas uncionalidades, sino que es una aplicaci´on e icien e, capaz de compe i con odas las dem´as aplicaciones de esc i o io emo o pa a And oid que exis en en es e momen o. Cabe des aca una ez m´as que la g an di e encia y la az´on po la que es e p oyec o es inno ado , es en que ninguna de las dem´as aplicaciones u ilizan c´odigo na i o, al menos no las de so wa e lib e. La imposibilidad de sabe como es ´an cons uidas las aplicaciones p i a i as nos impide a i ma con o al o undidad que no exis e una aplicaci´on de esc i o io emo o pa a And oid que u ilice el NDK. No obs an e, al no exis i una de so wa e lib e, la inno aci´on sigue es ando ah´ı, ya que hemos abajado sob e algo que no exis e en ning´un lado y con unos esul ados conside ablemen e buenos. 8.2. T abajo Fu u o Como posible abajo u u o se pod ´ıa a˜nadi sopo e pa a odos los idiomas, en dos sen idos. Po una lado la aducci´on de la in e az a di e os idiomas y, po o o, sopo e en el eclado pa a m´as idiomas. O a cosa que se pod ´ıa in es iga m´as es la acele aci´on po ha dwa e, de es a mane a se pod ´ıa consegui una mayo elocidad a la ho a de abaja las im´agenes y con ello se ob end ´ıa una mejo a del endimien o global conside able. Tambi´en pensa en po a la aplicaci´on a las dem´as pla a o mas m´o iles como Fi e ox OS. 51 52 Cap´ ı ulo 8. Conclusiones Bibliog a ´ıa [1] Wikipedia Esc i o io Remo o: h p://es.wikipedia.o g/wiki/Esc i o io_ emo o [2] Wikipedia Vi ual Ne wo k Compu ing: h p://en.wikipedia.o g/wiki/VNC [3] Remo e F ame Bu e P o ocol: h p://www. eal nc.com/docs/ bp o o.pd [4] Wikipedia And oid (ope a ing sys em): h p://en.wikipedia.o g/wiki/And oid_ (ope a ing_sys em) [5] So wa e De elopmen Ki : h p://de elope .and oid.com/sdk/index.h ml [6] Na i e De elopmen Ki : h p://de elope .and oid.com/ ools/sdk/ndk/index. h ml [7] Wikipedia Ja a Na i e In e ace: h p://en.wikipedia.o g/wiki/Ja a_Na i e_ In e ace [8] Tigh VNC, Tigh encoding: h p://www. igh nc.com/decode .php [9] Wikipedia Gi : h p://en.wikipedia.o g/wiki/Gi _(so wa e) [10] Gi : h p://gi -scm.com/ [11] Wi eSha k: h p://www.wi esha k.o g/ [12] F ee So wa e: h p://www. s .o g/abou /wha -is- ee-so wa e [13] Gene al Public License: h p://www.gnu.o g/licenses/gpl.h ml [14] Wikipedia RealVNC: h p://es.wikipedia.o g/wiki/RealVNC [15] Mul iVNC: h ps://play.google.com/s o e/apps/de ails?id=com. cobol o ge.don mind.mul i nc&hl=es [16] And oid- nc- iewe : h p://code.google.com/p/and oid- nc- iewe / [17] SDL: h p://www.libsdl.o g/ [18] Wikipedia Simple Di ec Media Laye : h p://es.wikipedia.o g/wiki/Simple_ Di ec Media_Laye [19] She lockBa : h p://ac ionba she lock.com/ [20] LibVNC: h p://lib ncse e .sou ce o ge.ne / [21] SlidingMenu: h ps://gi hub.com/j eins ein10/SlidingMenu 53 54 BIBLIOGRAF´ IA [22] SQLi e And oid: h p://de elope .and oid.com/ e e ence/and oid/da abase/ sqli e/package-summa y.h ml [23] In e az Holo: h p://de elope .and oid.com/design/s yle/ hemes.h ml Ap´endices 55 Ap´endice A Aqu´ı se p esen a una peque˜na desc ipci´on de c´omo se usa la aplicaci´on. Es e ex o de ayuda se puede e ambi´en desde la p opia aplicaci´on accediendo al men´u en la en ana p incipal. Se encuen a an o en espa˜nol como ingl´es, al igual que odos los di´alogos y ex o de los bo ones. Es el p opio sis ema And oid, en base al idioma seleccionado po de ec o en el sis ema ope a i o, el que selecciona el idioma a mos a . En caso de no dispone del idioma co espondien e al del sis ema, po de ec o se mos a ´an los ex o en ingl´es. A.1. P´agina de ayuda de VNC++ A.1.1. Manejo p incipal Pa a c ea una nue a conexi´on pulse el icono “+” en la ba a supe io de Acci´on (Ve Figu a A.1). Una ez den o, es necesa io especi ica la IP del se ido , as´ı como un nomb e de iden i icaci´on de la conexi´on. El pue o po de ec o es el 5900, pudi´endose cambia , as´ı como la con ase˜na, pudiendose deja en blanco si no se necesi a. Figu a A.1: Nue a conexi´on Figu a A.2: Vis a del esc i o io 57 58 Cap´ ı ulo A. El desplegable de calidades si e pa a indica la calidad de la imagen. Se puede elegi en e calidad supe -al a, al a, media o baja, seg´un el ipo de conexi´on del usua io ya sea m´as len a o ´apida, o simplemen e po necesidad de cie a calidad de imagen. En el bo ´on desplegable de opciones en la ac i idad p incipal se puede accede a es submen´us: La opci´on de Con igu aci´on: pe mi e, a a ´es de dos swi ches de selecci´on, ma ca si se ecue da o no la opci´on de con i ma salida, as´ı como ocul a el cu so o no (Ve Figu a A.3). Manual de uso pa ecido al que se es ´a na ando (Ve Figu a A.4). Secci´on “Ace ca de” donde se e lejan los c eado es de la aplicaci´on, as´ı como el ipo de licencia y las lib e ´ıas usadas (Ve Figu a A.8). Figu a A.3: Con igu aci´on Figu a A.4: Manual de uso A.1.2. Con ol de pes a˜nas Se puede cambia de pes a˜na pulsando sob e las e ique as RECIENTES o FAVORI- TOS, y as´ı e las dis in as conexiones c eadas (Ve Figu a A.5). A.1.3. A˜nadi a a o i os Pa a a˜nadi a a o i os ´unicamen e hay que clica sob e el icono con o ma de es ella (Ve Figu a A.5). Pa a qui a esa conexi´on de a o i os, se pulsa de nue o el icono ma cado, qui ´andose de la secci´on de a o i os. A.1. P´ agina de ayuda de VNC++ 59 A.1.4. Opciones de conexi´on Al pulsa sob e una conexi´on de la lis a, se p esen a un men´u de opciones. Desde ah´ı se puede conec a , mos a la in o maci´on de la conexi´on, edi a y elimina dicha conexi´on. Tambi´en se puede conec a pulsando el icono de la de echa con o ma de lecha. A.1.5. Opciones de edici´on Se pod ´a modi ica cualquie alo p e io de la conexi´on, a excepci´on del iden i icado elegido, del mismo modo que se c ea una nue a conexi´on. A.1.6. Men´u la e al Una ez ca gada la imagen se puede accede al men´u de opciones, an o desde el bo ´on ´ısico del e minal, como a as ando desde la izquie da de la pan alla pa a saca el men´u la e al. Una ez ah´ı se puede mos a eclado, manda eclas, cen a imagen, mos a una ayuda educida y desconec a (Ve Figu a A.6). Figu a A.5: Pes a˜nas Figu a A.6: Men´u la e al A.1.7. Manejo Pa a manda e en o click, simplemen e haga una pulsaci´on con el dedo. Pa a hace doble click, man enga p esionado el dedo sob e la pan alla du an e unos 3 segundos. Pa a hace zoom, coloque un dedo sob e la pan alla, mien as con o o dedo alejas o ace cas del p ime dedo, a modo de pinza.