https://github.com/timsutton/docker-download-xcode
Tools and docker image to automate downloading Xcode
https://github.com/timsutton/docker-download-xcode
Last synced: 5 months ago
JSON representation
Tools and docker image to automate downloading Xcode
- Host: GitHub
- URL: https://github.com/timsutton/docker-download-xcode
- Owner: timsutton
- Created: 2021-06-28T14:36:10.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2021-12-11T15:23:06.000Z (over 3 years ago)
- Last Synced: 2025-01-11T07:07:04.181Z (5 months ago)
- Language: Ruby
- Size: 6.84 KB
- Stars: 4
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# docker-download-xcode
**NOTE:** Xcode 13's xip archive uses a format that's incompatible with this method. This is documented in the [Xcode 13 release notes](https://developer.apple.com/documentation/xcode-release-notes/xcode-13-release-notes) (`Note: Other methods of expanding the archive may produce a broken Xcode app. (78714333)`) I haven't personally done any investigation as to fixing this.
A very much work-in-progress tool to help make fetching new Xcodes easier whether on macOS or Linux.
The approach is very similar to that of [XcodeInstall](https://github.com/xcpretty/xcode-install), except we obtain the download URLs via https://xcodereleases.com because:
* they are well-maintained, and quickly updated as new betas/release versions are released by Apple
* grabbing a download URL out of their JSON feed is simpler and less prone to breakage than needing to parse Apple's developer pages
* there is additional useful metadata not exposed by Apple at the feed level:
* the specific beta versions as well as build versions
* minimum required OS versions (equivalent of the `LSMinimumSystemVersion` Info plist key)
* compiler versions
* SHA-1 checksums of the .xip files
Ultimately I'm hoping to integrate this into an Xcode archiving-and-repackaging workflow that doesn't explicitly require macOS, using an approach like that of [docker-xip](https://github.com/timsutton/docker-xip).
## Setup
### From Docker:
Build a local docker image:
```
scripts/build.sh
```
It will need ADC credentials in order to retrieve Xcodes from the ADC portal. We can generate some persistent ADC credentials using [Fastlane Spaceship](https://github.com/fastlane/fastlane/tree/master/spaceship). One way to do this is via `fastlane spaceauth -u [email protected]` using the docker image we just built:
```
# using -it to run this interactively because it will prompt for a password and (likely) 2FA
docker run -it download-xcode fastlane spaceauth -u [email protected]
```
Copy-paste the `export FASTLANE_SESSION='...'` output. You'll also need to export `[email protected]`, and in my testing, a dummy password value for the password. The password bit might just be me holding Fastlane/Spaceship wrong.
```
export [email protected]
export FASTLANE_PASSWORD=nope
export FASTLANE_SESSION=''
```
### Locally:
If you want to use an existing local Ruby environment or not bother with Docker, you can simply run this locally:
```
# change to desired Ruby version
bundle install
bundle exec ruby app/download.rb
```
## Usage
Just run the docker image given an Xcode version as an argument:
```
scripts/run.sh 12.5.1
```
No beta versions supported yet.