Project

General

Profile

Android » README.txt

Dirk Petrautzki, 10/11/2012 10:26 AM

 
1
Requirements:
2

    
3
- A Smartphone or Tablet with Android version 4 (3 may also work but was not tested) and USB Host support; currently it's only known to work on galaxy nexus s and asus transformer tf300t
4
- Root access on Android
5
- a card reader supported by ccid (e.g. reiner sct basiskartenleser) or from reiner sct cyberjack series (standard and komfort reader) 
6
- USB Host cable and for the bigger readers an active usb hub for power feed (basis and standard work without)
7
- OR a keydock for your tablet with usb connector 
8
- a german identity card or a german eHealth card
9

    
10
Install:
11

    
12
For installing the app you can use adb if you already have the android sdk installed
13
	1. You need to modify your Android?s settings to allow the installation of applications from other sources. Under ?Settings,? select ?Security? and then enable ?Unknown Sources.?
14
	2. Open a command shell
15
	3. Install via 'adb install <path-to-app-on-local-harddrive>/android-1.0.0-pre2-SNAPSHOT.apk'
16
or 
17
	1. Copy the APK file to your Android?s memory.
18
    	2. Download and install a Apps Installer application from the Android Market
19
    	3. Once installed, the Apps Installer will display the APK files on the memory card.
20
    	4. Click and install the APK file.
21
or	
22
	1. Navigate with the browser of your android device to https://dev.openecard.org/attachments/download/149/android-1.0.0-pre2-SNAPSHOT.apk
23
	2. click on the link to the apk
24
	3. confirm to install downloaded apk
25

    
26

    
27
Testing:
28
	1. Open the Browser on your android device and navigate to http://dirk-petrautzki.de/rc_test.html
29
	2. Click on one of the diplayed links
30
	3. Select the open ecard app to deal with the opening (if you get a website not found error please start the open ecard app explicitely and restart with step 1)
31
	4. the open ecard app will guide you through the rest of the process in the end you'll be redirected to the browser and see the result of the authentication
32
	
33
Known issues:
34
	Under certain circumstances, the pcsc-daemon respectively the drivers hang due to problems how Android handles the threading. 
35
	To avoid this do only plug in a card reader or insert the german identity card at the beginning of the app.
36

    
37
	Solution: close the app and click again on the TCToken-link
(2-2/6)