iOS Museum App

App Store listing

This app's software was developed by team lead by Mark Barsi-Siminszky in Britannica International School, Budapest

The content was a collaborative effort between the secondary students of Birtannica and the museums of Budapest.

Software Development collaborators were:

• Gergely Maros
• Yingtao Zheng

There is also an Android only version of this application whose development is lead by Gergely Maros.

This app was made with .NET MAUI, and hence it can be run on iOS, Android, Windows, and Mac OS. However, it was optimized for mobile, and hence it isn't great on desktop.

Reporting issues

Please use the Issues tab on this page to do this.

Setup and run locally

1. If running a Mac, please install XCode.
2. Either: a. Install Visual Studio Community edition or Visual Studio for Mac. Make sure to install the .NET MAUI workload also. b. Install .Net, and run the command dotnet workload install maui.
3. Open the .sln file with Visual Studio or cd into the directory of your .sln if using .NET CLI.
4. Select your target platform (iOS Simulator on MacOS, Android Simulator on Windows), and start the app.

To test on a physical device from the terminal, see the doumentation.

Add new museum

1. Create the appropriate button, on the appropriate page, and create the appropriate TXT file named after the text on the button. Here is the code by which the TXT file will be selected.
2. Add a main image, name it the same as you did the TXT, just of course the file extension should be .png.
3. Inside the TXT file, please add the content using a markdown inspired markup language as follows:

Museum Name
---

# Heading

Content

# Heading 2

## Subheading 1

Content 2

---
# Heading only visible when user clicks "Expand"

Contnet only visible when user clicks "Expand"

# Heading2 only visible when user clicks "Expand"

Contnet2 only visible when user clicks "Expand"

!image.png:Alt text

Publish for iOS

While it can also be published for other platforms, this app was made with iOS in mind primarily.

Run the following to create a .ipa on a Mac:

dotnet publish -f:net7.0-ios -c:Release -p:RuntimeIdentifier=ios-arm64

If publishing to the store: -p:CodesignKey="{fill this out}" -p:CodesignProvision="{fill this out}"