Skip to content

Modified Readme.md. #5

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Modified Readme.md. #5

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
53afe2a
Added some needed steps to build.
howard-rti Aug 14, 2014
bd64f5f
Added info about Windows USB driver.
howard-rti Aug 22, 2014
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 10 additions & 3 deletions ShapesDemo/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,9 @@ These instructions are for a Windows development host.
1. Open Properties for the ShapesDemo project
2. Select "Java Build Path", and in the "Libraries" tab, use "Add External JAR" to add "nddsjava.jar" from
$(NDDSHOME)/class/
3. Copy "libnddsjava.so", "libnddsc.so", and "libnddscore.so" from $(NDDSHOME)/lib/armv7aAndroid2.3gcc4.8jdk
3. In the "Java Build Path" -> "Order and Export" tab, check to select "nddsjava.jar".
4. In the same tab, select "nddsjava.jar" and use the buttons on the side and move it to the top.
5. Copy "libnddsjava.so", "libnddsc.so", and "libnddscore.so" from $(NDDSHOME)/lib/armv7aAndroid2.3gcc4.8jdk
into the project directory libs/armeabi-v7a

7. To generate the APK, with the ShapesDemo project selected in the Project Explorer, you will need to select "Run" from the "Run" menu.
Expand All @@ -59,8 +61,11 @@ These instructions are for a Windows development host.
Please consult the Android eclipse SDK documentation for further information.


NOTE: On Windows, you may need to install or update your USB driver for your specific device.
Please see: http://developer.android.com/tools/extras/oem-usb.html

## Getting Started
------------------

1. Installing `ShapesDemo.apk` on a real Android Device
1. Attach your Device via USB
Expand Down Expand Up @@ -141,12 +146,15 @@ WiFi network (on the same subnet).
4. In ShapesDemo.exe (on your computer), you MUST change the Liveliness Kind of your
shape publishers (datawriters) to `MANUAL_BY_TOPIC` for the Android subscriber to receive the data.


5. Notes:
ShapesDemo on Android is configured by default to publish/subscribe using `BEST_EFFORT_RELIABILITY`
and `MANUAL_BY_TOPIC` Liveliness kind.


6. See Troubleshooting section below if you can't get the two ShapesDemos to exchange data.


File Description
-----------------
### Java ###
Expand All @@ -166,8 +174,6 @@ File Description
* `src/com/rti/android/shapesdemo/util/EditTextPreferenceWithValue.java` - Useful class so that when a preference (setting/option) is changed by the user, the new value is automatically reflected in the preferences menu.




### Android Application Files ###

* `AndroidManifest.xml` - Main definition file for ShapesDemo app including which Activity to start on startup
Expand All @@ -182,6 +188,7 @@ File Description


## Troubleshooting
-------------------

1. ShapesDemo can't publish or subscribe to host?

Expand Down