Home Access Plus+ (HAP) for iOS provides a native app to connect your Apple device to your institutions Home Access Plus+ server. You can then browse, upload and download files easily to and from your iOS device to your institution network file drives. A demo video and additional screenshots are available to view of the app in action (version 0.5.0).
To be able to use this app, you will need to have the following:
- A device running iOS 9.0+
- Home Access Plus+ set up and running for your institution (bug your network managers to get this set up… it's free)
Before asking for help or reporting a bug, please read through the Frequently Asked Questions to see if the problem can be resolved.
Thanks for your interest in contributing to this project. You can contribute or report issues in the following ways:
- Sign up for beta testing to explore and test the app through Testflight
- Download a release or clone the latest code and run it on your own device (Xcode is needed to build the project)
- Report a bug if something isn't working as you expect it to
- Suggest an improvement for something that you'd like to see
If you would like to create a pull request, please make sure that you are on the develop branch before opening one. Once you have cloned or forked this repo, open the HomeAccessPlus.xcworkspace file in Xcode to begin development. This project uses git-flow as its branching model.
The current development environment is with Xcode 8.2 and Swift 3.0.2. Please make sure you are using these versions before submitting any pull requests
The following users have contributed code or suggestions to this project:
Apps built for iOS 10+ must declare the purpose for access to any user private data types (sources: 1, 2, 3). Since this project uses the PermissionScope Cocoapod a number of additional unused permissions are requested (GitHub Issue). Please see the Frequently Asked Questions for more information.
Home Access Plus+ for iOS is publised under the GNU GPL v3 License, see the LICENSE file for more information.
The name "Home Access Plus+" and all server side code are copyright Nick Brown (nb development)
This project uses Cocoapods. Their project source code pages and licenses can be found below:
- Alamofire
- ChameleonFramework
- DKImagePickerController
- Font Awesome Swift
- Locksmith
- MBProgressHUD
- PermissionScope
- SwiftyJSON
- XCGLogger
- Zip
The following projects and source code are included in HAP+ for iOS. Their licenses project pages can be found below:
The following features are planned for the Home Access Plus+ iOS app, along with their expected releases (which can change).
- "Favourite" folders for devices in personal or single mode, using a tab bar to select between the my files or favourites "views" -- the use of swiping the table row right to select items could be used to show a favourite button
- Create a zip file from any selected items items
- (Optional branding) Set a logo and theme (including app icon) colour based on those used by the school to use throughout the app -- information possibly collected by accessing a app-config.json file located on the HAP+ server somewhere
- Support for document provider open and move options for apps that do not support import and export -- possibly won't happen, as all attempts to get this working so far haven't been successful