Skip to content

Using Turtle locally.md

Latest commit

 

History

History
46 lines (32 loc) · 2.22 KB

Using Turtle locally.md

File metadata and controls

46 lines (32 loc) · 2.22 KB

Using Turtle locally

This document will guide you through building standalone app from Managed Expo project using local Turtle builder.

Prepare turtle-cli

  1. Ensure you've got turtle-cli installed locally

npm i -g turtle-cli

  1. turtle has some references for shellTarballs - these are located under <place where turtle is installed>/turtle-cli/shellTarballs
cd `which turtle`/../../shellTarballs
  1. turtle downloads shellTarballs and places them under ~/.turtle/workingdir directory (/android or /ios respectively).

Replacing Android/iOS shellTarball used during build process

You can replace specific shellTarball by replacing existing one with yours:

You can take a look at /.circleci/config.yml file and search for shell_app_ios_build or shell_app_android_build commands. There are responsible for preparing new shellTarballs that are used by turtle service to build standalone Expo apps from Managed Expo projects.

Replacing Android shellTarball

  1. Run et android-build-packages --packages all.
  2. Run ./buildAndroidTarballLocally.sh. That would create freshly packed shellTarball under artifacts directory.

You cannot prevent script from archiving shellTarball, because it has to move actual files and not symlinks.

  1. Remove shellTarball from ~/.turtle/workingdir/android/<sdkXX>.
  2. Recreate removed directory & extract new shellTarball into that directory:
tar -zxvf ./artifacts/android-shell-builder.tar.gz --directory ~/.turtle/workingdir/android/<sdkXX>
  1. turtle-cli checks for correctness of shellTarball by looking for .ready file containing URL that points to shellTarball available online. We need to fool turtle-cli by creating such file that would contain correct URL address.
cat `<place where turtle is installed>/turtle-cli/shellTarballs/android/sdkXX > ~/.turtle/workingdir/android/<sdkXX>/.ready
  1. yarn in extracted directory.
  2. Remove contents of android/maven directory inside the expo repository.

Replacing iOS shellTarball

  1. Create new shellTarball by following commands from /.circleci/config.yml describing shell_app_ios_build task.
  2. Replace current shellTarball with freshly built one (see Android section).