Skip to content

Latest commit

 

History

History
55 lines (42 loc) · 3.41 KB

WPiOS Integration.md

File metadata and controls

55 lines (42 loc) · 3.41 KB
Raw

WordPress iOS Integration Guide

How to work with local gutenberg-mobile checkout

The LOCAL_GUTENBERG environment variable is useful when you want to iterate on the native iOS code (Swift, Objective-C) in gutenberg-mobile while testing it inside the WPiOS app. This also includes the case when you update a dependency in gutenberg-mobile that includes native code.

The LOCAL_GUTENBERG flag sets which JS bundle WPiOS uses. It does not impact which WPiOS run scheme is selected or whether or not Metro is used. When the flag is enabled, the bundle available within the local gutenberg-mobile checkout is used. That's why, when using this flag, it is better to run the Metro server or recreate JS bundles in the local gutenberg-mobile checkout so that the native and JS code are in sync.

To use it, you need to set LOCAL_GUTENBERG environment variable to the local gutenberg-mobile folder relative to the WPiOS folder.
By default LOCAL_GUTENBERG is set to ../gutenberg-mobile.

  1. First cd into your cloned WPiOS project folder and run rake dependencies
  2. (a) If gutenberg-mobile is at ../gutenberg-mobile you can directly run:
LOCAL_GUTENBERG=true bundle exec pod install
  1. (b) Otherwise pass in the relative gutenberg-mobile folder like this:
LOCAL_GUTENBERG=../../xyz/gutenberg-mobile bundle exec pod install
  1. Start the metro server in gutenberg-mobile with npm run start:reset
  2. Launch the WPiOS workspace (.xcworkspace) in Xcode and run the app
  3. You can change any JS files and metro should pick the changes up
  4. If you change any native files (Swift, Objective-C, etc.) you should re-run the WPiOS app for the changes to be reflected

How to test a gutenberg-mobile PR in WPiOS

Assuming that there is no open WPiOS PR:

  1. Open Podfile in WPiOS project
  2. Find the line where gutenberg reference is set like: gutenberg :tag => 'vX.YY.Z'
  3. Find latest commit hash of the gutenberg-mobile PR
  4. Replace the gutenberg reference with the commit hash: gutenberg :commit => '123456789'
  5. Run bundle exec pod install inside WPiOS
  6. Switch to the relevant branch in gutenberg-mobileand start the metro server with npm run start:reset
  7. Launch the WPiOS workspace (.xcworkspace) in Xcode and run the app

Additionally to share a WPiOS installable build (IPA)

  1. Within gutenberg-mobile, stop the metro server and create bundles running npm run bundle
  2. Commit and push the bundle changes to gutenberg-mobile
  3. Update the commit hash in the WPiOS Podfile again and run bundle exec pod install again
  4. Commit and push the changes to Podfile and Podfile.lock
  5. Open a WPiOS PR
  6. Manually trigger the installable build CI job by clicking the link in the PR comments

Additionally to release a alpha version of gutenberg-mobile and update WPiOS PR to use it

  1. Merge the gutenberg-mobile PR (make sure the bundles are up-to-date before merging)
  2. Tag the merge commit bumping the latest tag's minor version and adding an -alphaQ to the end like: v1.50.0 -> v1.51.0-alpha1
  3. If there's already an alpha, the alpha version could be increased like: v1.51.0-alpha1 -> v1.51.0-alpha2
  4. Open the Podfile again and update the gutenberg reference to use the new alpha tag: gutenberg :tag => 'v1.51.0-alpha2'
  5. Run bundle exec pod install
  6. Commit and push the changes to Podfile and Podfile.lock