Skip to content

Latest commit

 

History

History
87 lines (55 loc) · 4.25 KB

README.md

File metadata and controls

87 lines (55 loc) · 4.25 KB
Raw

SecureShareLib

SecureShareLib is an Android Library that allows apps to integrate a transfer manager that runs in a background service and has some capability to retry transfer on device reboot.

This package was originally forked from the AOSP Download Provider package. We extended it's classes to allow for both Downloads and Uploads in its database and content provider.

###Building

  • Place your Flickr keys in res/values/flickr.xml with your own from Flickr's create site page

Example:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- insert your own keys from: https://www.flickr.com/services/apps/create/apply/ -->
    <string name="flickr_key">REPLACE_WITH_YOUR_KEY</string>
    <string name="flickr_secret">REPLACE_WITH_YOUR_KEY</string>
</resources>

Example:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- insert your own keys from: https://www.flickr.com/services/apps/create/apply/ -->
    <string name="google_client_id">REPLACE_WITH_YOUR_ID</string>
    <string name="google_client_secret">REPLACE_WITH_YOUR_SECRET</string>
    <string name="google_app_name">REPLACE_WITH_YOUR_APP_NAME</string>
</resources>

###What's next?

In the next release we will merge this code with the fork of the Download Manger (here) that has been split out from being an internal platform app into being a stand alone Android SDK app. This will allow us to build the Transfer Manager

###Future Reseach

  • Plugin API

We will investigate how to allow 3rd party packages to expose their own transfer implementations at runtime via a plugin interface. This would allow a more dynamic list of supported partner platforms.

  • Resume

Some services such as Youtube or Rsync allow us to resume after an interrupted transfer. We plan to extend our api to allow us to support this for those platforms

  • Rate limiting

We intend to add the ability to lower the rate of trasnfer so as to not saturation your mobile data link

###Issues You may get the following errors when trying to build the project:

  • Unable to execute dex: Multiple dex files define Lorg/json/JSONArray;
  • Conversion to Dalvik format failed: Unable to execute dex: Multiple dex files define Lorg/json/JSONArray;

These are caused when there are two duplicate jar files seen from the main project. To fix this issue, follow the steps below:

  • remove the conflicting jar from the sub-project (delete the soundcloud-api-wrapper.jar from the libs folder in SecureShareLib)
  • right click the project name
  • go to properties
  • select 'Java Build Path' on left menu, then the 'Libraries' tab
  • click 'Add JARs' button on right and point it to the soundcloud-api-wrapper.jar (located in secureshareuilibrary/external/)
  • clean and rebuild

###Dex Issue Due to the large number of dependencies, SecureShare has hit Android's DEX 65K methods limit. You can read more about this issue here.

The error message: Unable to execute dex: method ID not in [0, 0xffff]: 65536 Conversion to Dalvik format failed: Unable to execute dex: method ID not in [0, 0xffff]: 65536

The workaround: We have found a way to go through the problematic JAR files and remove the unused packagages manually. We used the google-play-services script here, and then modified it to work with the amazon JARs as well. You can find the sripts and their corresponding files in the external/dex-libs-issue/ folder. Simple run the .sh scripts and it will generate minified versions of the JAR files.

###Credits

SecureShareLib was developed by Scal.io and Small World News as part of the StoryMaker project with the generous support of Open Technology Fund.

StoryMaker - Make your story great

Authors