Android client for Synergy, requires a modded Android with access to /dev/uinput (e.g. Cyanogen).
License: GNU General Public License v2.0
Shell 0.07%Java 81.59%Makefile 0.43%C 17.91%
synergy-android's Introduction
APK download: http://sourceforge.net/projects/synergyandroid/files/
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
------------------------