Descarga del APK: bin/Synergy.apk

-----------------------------------------------------------------------
Introducción
-----------------------------------------------------------------------
SynergyAndroid es un cliente Synergy para la plataforma Android.
Ver http://synergy-project.org para detalles. Actualmente en fase de
desarrollo.
Los nuevos desarrolladores son bienvenidos a unirse.

-----------------------------------------------------------------------
Pre-requisitos
-----------------------------------------------------------------------
Nosotros utilizamos el módulo uinput para la manipulación de periféricos, 
por lo que debemos tener un Android Roteado con acceso a /dev/uinput 
(Como Cyanogenmod). Eso significa que tu android debe tener el archivo
/dev/uinput y debe ser RW (con permisos de escritura).

-----------------------------------------------------------------------
Armando el Proyecto
-----------------------------------------------------------------------
SynergyAndroid utilizar "jni" para acceder al archivo /dev/uinput, por
lo que primero debe compilar el código fuente jni por NDK. Y luego
podrá construir y depurar el proyecto en eclipse.


    $./build_jni.sh <NDK Base>

Puede descargar el NDK desde:
https://developer.android.com/tools/sdk/ndk/index.html

A continuación, simplemente importar el proyecto en Eclipse.

-------------------------------------------------------------------------
Ejecución 
-------------------------------------------------------------------------
Recuerde: Debe compilar el código jni y luego dar permisos de escritura
a /dev/uinput.

Entonces puede instalarlo:
OPCIÓN 1. Ejecutarlo desde Eclipse.
OPCIÓN 2. Instalarlo con RUTA_DEL_PROYECTO/bin/Synergy.apk al emulador/movil.
            $adb install RUTA_DEL_PROYECTO/bin/Synergy.apk
OPCIÓN 3. Copiar y pegar en el dispositivo e instalarlo normalmente.



-----------------------------------------------------------------------
-----------------------------------------------------------------------

APK download: bin/Synergy.apk

Introduction
-----------------------------------------------------------------------
SynergyAndroid is a port of the synergy client to the Android platform. 
See http://synergy-project.org for detail. Currently in the planning stage.
New developers are very welcome to join in.

Pre-requirements
-----------------------------------------------------------------------
We use the uinput module for user space input driver, so you must have
a modded Android with access to /dev/uinput (Like Cyanogen). That means
your android must have /dev/uinput module and this file can be RW by app.

You can follow blow steps to set a custom android emulator for testing:

    1. Clone the android kernel source from android.git.kernel.org
        #git clone git://android.git.kernel.org/kernel/common.git
    2. Check out the emulator branch
        #git checkout -t origin/android-goldfish-2.6.29 -b goldfish
    3. Generate the kernel configuration for emulator
        #make ARCH=arm goldfish_defconfig
    or get a config copy from a exist emulator rom.
        #adb pull /proc/config.gz
    4. Edit the .config file, make sure 
        CONFIG_INPUT_UINPUT=y
    5. Compile the kernel using cross toolchain (you can get prebuilt 
       cross toolchain from android source repo or just
        #git clone git://android.git.kernel.org/platform/prebuilt.git
       all platform cross chain are there.)
        #make ARCH=arm CROSS_COMPILE=prebuilt/YOUR_PLATFORM/toolchain/arm-eabi-4.2.1/bin/arm-eabi-
        
    6. Now, the kernel built is in the arch/arm/boot/ folder. 
       You can start the emulator with this kernel
        #emulator -avd YOUR_AVD -kernel ANDROID_KERNEL_PATH/arch/arm/boot/zImage 
       
    7. At last, you should make sure your app can read and write /dev/uinput
        #adb shell chmod 660 /dev/uinput
       
    8. Now, you can build the project and test it.
 
Building the project
-----------------------------------------------------------------------
SynergyAndroid use the jni to access the /dev/uinput module, so you must
compile the jni source by NDK firstly. And then you can directly build 
and debug the project in eclipse.
   
    #./build_jni.sh <NDK Base>

then just build the whole project in eclipse.

Running 
-------------------------------------------------------------------------
Reminder: you should build the jni source first and chmod 666 /dev/uinput

Then you can:
1. just run the project in eclipse or 
2. install the PROJECT_PATH/bin/Synergy.apk to emulator/device. 
      #adb install PROJECT_PATH/bin/Synergy.apk

TODOs
----------------------------------------------------------------------
Client reconnect
Proper handling of shift, alt, caps lock... etc.  

Options to Implement
-------------------------
Logging level
Port number
Retry interval ?

Key Translation
------------------------