Skip to content

iFixit/iFixitAndroid

Repository files navigation

Official iFixit Android App v2.9.2

This app is a native Android version of the iFixit website including:

  • Device hierarchy browsing
  • Answers and guide lists for devices
  • Guide view
  • Viewing and adding comments on guides
  • Media manager integration: viewing and uploading of images
  • Guide lists for favorites, featured, and teardowns
  • Guide creation and editing
  • Syncing guides for offline viewing

Installation

Start by cloning the repo:

git clone https://github.com/iFixit/iFixitAndroid.git

Copy gradle.properties.base to gradle.properties. This contains all of the values necessary to build the app in debug mode. To build the app in release mode, update the necessary keystore information and symlink App/sites/{siteName}/keystore to your keystore like so:

ln -s /path/to/keystore App/sites/ifixit/keystore

Open build.gradle in your IDE of choice or build it on the command line by invoking gradle commands such as gradle installIfixitDebug.

Acknowledgements

All of the app's content comes from iFixit's public API.

The app is built on many open source libraries such as:

The complete list of dependencies can be found in the build.gradle file.

Contributing

We have a small development team, and don't have the resources to implement all of the features we would like to ourselves. We'd love help! If there is any feature you would contribute, fork our code and hack away!

Got an awesome feature idea that we don't have an API to support yet? Post the request on iFixit Meta and we'll add it to our to-do list.

Before your code can be accepted into the project you must also sign the Individual Contributor License Agreement (CLA).

Licensing

This source code is licensed under the GPLv3. Any submissions to this project must also be licensed under GPLv3. The contents of this software are subject to the terms of the GNU General Public License (the "License"). You may not use this software except in compliance with this License. You can obtain a copy of the license at http://www.gnu.org/licenses/gpl-3.0.txt. See the License for the specific language governing permissions and limitations under the License.

TRADEMARK NOTES

All iFixit trademarks contained herein are NOT licensed for use by any third-parties. Their inclusion in this open source software is only for their eventual replacement if you distribute the application.

That is, the trademarks are protected, but the code itself is under an open license. You can use the trademarks individually, but not for any sort of distribution.

Copyright (c) 2012-2016 iFixit