The application allows users to set custom words to have specific functions. These functions can range from texting a friend, sending a location, or calling authorities, though not all are fully implemented yet. SafeWord provides a user-friendly interface that allows users to add words and decide which tasks are associated with that word. Once a customized word is said aloud while the application is activated, the application will execute the word’s tasks.
These notes will provide an overview of SafeWord's (v1.0) primary features and how to install it onto an iPhone device.
-Add words that have location text triggers by toggling "Send Location" on a created word
-Add contacts to text by adding a contact and selecting the words to trigger that contact on
-Activate and deactive the application, allowing users to decide when words will be triggered
-Say trigger words during activated state to trigger the contacts that the user has set
-Contacts added to words will now be contacted instead of a hard-coded contact
-Activation can now be turned on and off indefinitely
-Currently only supports texting contacts a predetermined location
-Record audio and delay toggles are placeholders
-Only contacts mapped on the Contact page to words will be triggered, though a mapping to contacts is provided for words
-Must deactivate app for triggers to commence
SafeWord is built on Ionic 2, allowing one to deploy on Android and iPhone. However, the code is currently written to be optimized for iOS, so this guide will be geared towards iPhone installation and execution.
XCode Version 9.1
iPhone running iOS 10 or later
The project can be directly cloned or downloaded from the SafeWord github: https://github.com/aparry3/SafeWord
-Make sure to have XCode and dependencies installed
-Download SafeWord project from the Github
-Navigate to the top level of the project in your terminal
run:
ionic cordova build ios --prod
to build the project. You may have to run the following if the iOS platform is missing:
ionic cordova platform add ios
Once the project is built, open it within XCode by navigating to SafeWord/platforms/ios/MyApp.xcodeproj
Plug in your iPhone device. In XCode, select the target device for MyApp to be your device. Then, under Product, in XCode's toolbar, select Run. An error will appear saying that the app needs proper permissions on your device to run. On your iPhone, navigate to Settings, then General, and then Device Management. This is where you can allow your device to accept the app to run. After saying you trust this developer, hit run again and the application will deploy and automatically open.
The app will now run on your phone like any other iPhone application. Serious bugs may require redeployment by deleting and repeating the steps above.
If you run into problems downloading and running the solution the following may help:
- Older versions of XCode will not work with the latest iOS, and visa versa. Make sure to have both fully updated
- Redeploy the application by deleting and redownloading the SafeWord directory (Configuration files could have been tampered by running otherionic cordova commands)
- Check your computer's applications to be sure the necessary pre-requisites described above are installed
- Try turning your computer off and then on again (This will ensure that any restart dependent installations have occured)