Skip to content

Latest commit

 

History

History
56 lines (34 loc) · 2.34 KB

iOS.md

File metadata and controls

56 lines (34 loc) · 2.34 KB
Raw

Installation - iOS

After setting up your environment, you can follow the steps below to run the pass Culture mobile application on iOS.

Further installation process

To install iOS modules (pods), we use Cocoapods (dependency manager). It is built with Ruby, so make sure it is installed on your computer.

We use bundler to install our Ruby gems. You can install it with gem install bundler.

Now you can install Cocoapods with bundle install. This will install the gems.

To install the pods, and create the Pods folder, run:

  • bundle exec pod install inside the folder ios
  • you may be asked to run bundle exec pod repo update

🔥 Firebase setup

You will need to add the GoogleService-Info.plist file in the ios directory. You can get a copy of the testing configuration one through the password manager, or directly through the Firebase console inside Project Settings.

Setup Xcode to launch the app in the Simulator or on your external device

In order to launch the app in your Apple device, you need to follow these steps:

Download the iOS certificates to your computer:

  1. Create an Apple Developer passCulture account (https://developer.apple.com/).
  2. Connect to the Apple Developer account with Xcode.
  3. Get invited to the Apple Developer group by an Admin.
  4. Download the private key via fastlane: bundle exec fastlane ios download_certificates --env testing
  5. When required, use the git ssh URL of the private certificates repository pass-culture-app-native-certificates.
  6. Get the match repo passphrase on 1password in the "Tech" vault.

(Only the first time) Set arbitrary Version and BuildVersion numbers of the App in Xcode at PassCulture > General > Identity > Build

For example :

  • Version : 1.176.0
  • Build : 10176000

🚀 Run the app with yarn

  • For Apple External Device

Connect your device to the computer and run yarn ios:testing --device or use the Xcode interface. Choose a scheme (your device) and click the Run button in the toolbar. More info here.

  • For Xcode Simulator

Run yarn ios:testing or use the Xcode interface. More info here. This will also start the metro server. If not, run yarn start in another tab.