NOI Community App for iOS

The NOI-Community App is your information and communication channel to keep in touch with the growing innovation district of NOI Techpark and its members. Are you looking for a specific company that is working here? Do you need to book a room for your next team meeting? Or do you simply want to know today's choice of dishes in the Community Bar? From now on, you can find all that in one application. More tools to come, so stay tuned!

We have also an App for Android.

Table of Contents

• NOI Community App for iOS
  • Getting started
    • Prerequisites
    • Source code
    • Configure the project
  • Running tests
  • Deployment
  • Information
    • Support
    • Contributing
    • License

Getting started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

To build the project, the following prerequisites must be met:

1. Xcode 12 (downloadable from https://developer.apple.com/xcode/resources/)
2. Be a member of NOI SPA Apple Developer Team (if you want to run the app and tests on your device) (write a mail to [email protected], if you need access)

Source code

Get a copy of the repository:

git clone [email protected]:noi-techpark/it.bz.noi.community.ios.git

Configure the project

No configuration is needed.

Running tests

The unit tests can be executed on a device by replacing <device_name> with your device name with the following command:

xcodebuild  -project NOICommunity.xcodeproj \
-scheme NOICommunity \
-destination 'platform=iOS,name=<device_name>' \
clean test

or on an iOS simulator by replacing <simulator_name> with a simulator name with the following command:

xcodebuild  -project NOICommunity.xcodeproj \
-scheme NOICommunity \
-destination 'platform=iOS Simulator,OS=14.5,name=<simulator_name>' \
clean test

When you install Xcode it comes with default simulators, one per each supported device and its simulator name is the device model; e.g. "iPhone 12".

For some examples see .github/workflows.

Deployment

We deploy the application with Github Actions to a Test Track, if someone pushes to the main branch. See .github/workflows/main.yml and Continuous Deployment for iOS Apps for details...

After the CD pipeline completes, we have a new release. This release will be send to all internal testers automatically. Internal testers are mostly developers and are registered in the App Store as such. External testers can just use a link that can be found under TestFlight > External Testing. There is no need to add explicit users there.

Please note, that external releases are not automatic, you need to click on the "Build +" button, and add the newest build there.

Information

Support

For support, please contact [email protected].

Contributing

If you'd like to contribute, please follow our Getting Started instructions.

License

The code in this project is licensed under the GNU GENERAL PUBLIC LICENSE 3.0 or later license. See the LICENSE file for more information.

REUSE

This project is REUSE compliant, more information about the usage of REUSE in NOI Techpark repositories can be found here.

Since the CI for this project checks for REUSE compliance you might find it useful to use a pre-commit hook checking for REUSE compliance locally. The pre-commit-config file in the repository root is already configured to check for REUSE compliance with help of the pre-commit tool.

Install the tool by running:

pip install pre-commit

Then install the pre-commit hook via the config file by running:

pre-commit install