Hello!

I was trying to install on an M1 Mac mini via Homebrew, but I'm running into the following error:

make
install
prefix=/opt/homebrew/Cellar/xcodes/0.17.0

error: terminated(72): HOMEBREW_ANALYTICS_USER_UUID=5F2AFA1B-A39F-4154-9C0B-916EAE829EF4 MAKEOVERRIDES=${-*-command-variables-*-} HOMEBREW_GIT_CONFIG_FILE=/opt/homebrew/Homebrew/.git/config TERM=xterm-256color HOMEBREW_LIBRARY=/opt/homebrew/Homebrew/Library HOMEBREW_BREW_DEFAULT_GIT_REMOTE=https://github.com/Homebrew/brew CARGO_HOME=/Users/Administrator/Library/Caches/Homebrew/cargo_cache ACLOCAL_PATH=/opt/homebrew/share/aclocal TMPDIR=/private/tmp CC=clang GOCACHE=/Users/Administrator/Library/Caches/Homebrew/go_cache TMP=/private/tmp HOMEBREW_CELLAR=/opt/homebrew/Cellar MFLAGS=- --jobserver-fds=3,4 -j HOMEBREW_DEPENDENCIES= MAKELEVEL=1 HOMEBREW_USER_AGENT_CURL=Homebrew/3.1.5 (Macintosh; arm64 Mac OS X 11.2.3) curl/7.64.1 HOMEBREW_CACHE=/Users/Administrator/Library/Caches/Homebrew HOMEBREW_ARCHFLAGS= HOMEBREW_CC_LOG_PATH=/Users/Administrator/Library/Logs/Homebrew/xcodes/01.make HOME=/private/tmp/xcodes-20210503-31493-19bsi4e/.brew_home HOMEBREW_NO_BOOTSNAP=1 HOMEBREW_REQUIRED_RUBY_VERSION=2.6.3 OBJC=clang HOMEBREW_PROCESSOR=arm64 HOMEBREW_BOTTLE_DEFAULT_DOMAIN=https://ghcr.io/v2/homebrew/core HOMEBREW_SYSTEM=Macintosh CXX=clang++ HOMEBREW_OPTFLAGS= SDKROOT=/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk MAKEFLAGS= --jobserver-fds=3,4 -j -- prefix=/opt/homebrew/Cellar/xcodes/0.17.0 HOMEBREW_COMMAND_DEPTH=2 HOMEBREW_BREW_GIT_REMOTE=https://github.com/Homebrew/brew HOMEBREW_LIBRARY_PATHS=/opt/homebrew/lib:/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/System/Library/Frameworks/OpenGL.framework/Versions/Current/Libraries HOMEBREW_MACOS_VERSION=11.2.3 HOMEBREW_REPOSITORY=/opt/homebrew/Homebrew HOMEBREW_OS_VERSION=macOS 11.2 HOMEBREW_RUBY_WARNINGS=-W1 prefix=/opt/homebrew/Cellar/xcodes/0.17.0 __CF_USER_TEXT_ENCODING=0x1F6:0x0:0x52 HOMEBREW_FORMULA_PREFIX=/opt/homebrew/Cellar/xcodes/0.17.0 HOMEBREW_AUTO_UPDATE_CHECKED=1 HOMEBREW_CORE_DEFAULT_GIT_REMOTE=https://github.com/Homebrew/homebrew-core HOMEBREW_CORE_GIT_REMOTE=https://github.com/Homebrew/homebrew-core HOMEBREW_DEFAULT_LOGS=/Users/Administrator/Library/Logs/Homebrew HOMEBREW_MACOS_SYSTEM_RUBY_NEW_ENOUGH=1 HOMEBREW_LOGS=/Users/Administrator/Library/Logs/Homebrew HOMEBREW_ERROR_PIPE=/private/tmp/homebrew20210503-30518-1jfis6f/socket HOMEBREW_PRODUCT=Homebrew HOMEBREW_PREFER_CLT_PROXIES=1 HOMEBREW_ANALYTICS_ID=UA-76679469-1 HOMEBREW_CURL=curl CMAKE_INCLUDE_PATH=/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/System/Library/Frameworks/OpenGL.framework/Versions/Current/Headers HOMEBREW_ISYSTEM_PATHS=/opt/homebrew/include:/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/System/Library/Frameworks/OpenGL.framework/Versions/Current/Headers HOMEBREW_SDKROOT=/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk LOGNAME=Administrator HOMEBREW_PREFIX=/opt/homebrew HOMEBREW_CC=clang PWD=/private/tmp/xcodes-20210503-31493-19bsi4e TEMP=/private/tmp HOMEBREW_MINIMUM_GIT_VERSION=2.14.3 CMAKE_PREFIX_PATH=/opt/homebrew HOMEBREW_GIT=git SOURCE_DATE_EPOCH=1614371456 HOMEBREW_CXX=clang++ HOMEBREW_ENV=super SHLVL=1 OBJCXX=clang++ USER=Administrator HOMEBREW_MACOS_VERSION_NUMERIC=110203 HOMEBREW_RUBY_PATH=/System/Library/Frameworks/Ruby.framework/Versions/Current/usr/bin/ruby CURL_HOME=/Users/Administrator SHELL=/bin/zsh HOMEBREW_OPTIMIZATION_LEVEL=Os HOMEBREW_USER_AGENT=Homebrew/3.1.5 (Macintosh; arm64 Mac OS X 11.2.3) PATH=/opt/homebrew/Homebrew/Library/Homebrew/shims/mac/super:/usr/bin:/bin:/usr/sbin:/sbin GOPATH=/Users/Administrator/Library/Caches/Homebrew/go_mod_cache HOMEBREW_DEVELOPER_DIR=/Library/Developer/CommandLineTools LC_ALL=en_US.UTF-8 PKG_CONFIG_LIBDIR=/usr/lib/pkgconfig:/opt/homebrew/Homebrew/Library/Homebrew/os/mac/pkgconfig/11 HOMEBREW_VERSION=3.1.5 _=/usr/bin/swift HOMEBREW_DEFAULT_CACHE=/Users/Administrator/Library/Caches/Homebrew HOMEBREW_BREW_FILE=/opt/homebrew/bin/brew HOMEBREW_DEFAULT_TEMP=/private/tmp HOMEBREW_OPT=/opt/homebrew/opt _JAVA_OPTIONS=-Duser.home=/Users/Administrator/Library/Caches/Homebrew/java_cache HOMEBREW_TEMP=/private/tmp CMAKE_LIBRARY_PATH=/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/System/Library/Frameworks/OpenGL.framework/Versions/Current/Libraries HOMEBREW_CCCFG=Oa /usr/bin/xcrun --sdk macosx --find xctest output:
    xcrun: error: unable to find utility "xctest", not a developer tool or in PATH

make: *** [xcodes] Error 1

It's a pretty close to fresh install of macOS, so Xcode is not already installed (which seems to be the root cause of the unable to find utility "xctest" error based on some cursory googling).

Let me know if there's any other info I can provide!

When I try to download any version:

• it downloads about 100KBs of it
• considers it 100%
• then fails with the error: The archive "Xcode-14.0.0+14A309.xip" is damaged and can't be expanded.

I have tried both with the CLI and the Xcodes app. (Both of them were installed through Homebrew)

When I run it from the CLI, I see the following output:

xcodes install --latest --experimental-unxip
Updating...
Latest non-prerelease version available is 14.1

Downloading with aria2

(2/6) Unarchiving Xcode (This can take a while)
Using experimental unxip. If you encounter any issues, remove the flag and try again
zsh: trace trap  xcodes install --latest --experimental-unxip

I presume the last line is the issue?

EDIT:

• I have tried with and without aria2
• I have tried with and without --experimental-unxip
• I have tried multiple Xcode versions

Can't get the list of Xcodes from Apple when login with 2FA account.

$ xcodes list
Apple ID: [email protected]
Apple ID Password:
Enter the code:
000000
The data couldn’t be read because it is missing.

Second try is the same:

$ xcodes list
Enter the code:
000001
The data couldn’t be read because it is missing.

I'm mainly using xcodes as a replacement for Ruby-based xcversion. Unfortunately, xcodes lacks a great feature when compared to xcversion, that is simulator version management. It would be great if xcodes was able to provide a list of available simulators and install a specificied version.

This PR adds a new command xcodes runtimes, which is intended to be a replacement for xcversion simulators from xcode-install. I chose the word "runtimes" to avoid confusion with the actual simulators (ie. iPhone Xs), which is also how apple refer to it in xcrun simctl runtime.

xcversion simulators used a list specific to each installed Xcode, this is now deprecated and now Apple returns all possible runtimes, which makes filtering our responsibilty.

A recent change in Apple's 2FA a few days ago breaks xcodes' authentication.

$ xcodes update
You must sign in to https://appstoreconnect.apple.com and acknowledge the Apple ID & Privacy agreement.

fastlane works around it by allowing to opt-in to skipping 2FA upgrade by setting SPACESHIP_SKIP_2FA_UPGRADE=1: https://github.com/fastlane/fastlane/pull/18116.

This PR builds on #223, and adds a command for installing runtimes xcodes runtimes install 'iOS 14.5'

~~Downloading will require an Apple account for new platforms released in 2022, it's not needed for older platforms.~~

Installing is still a WIP

I want to install the latest version about the Xcode , I also installed Xcodes completely, and then run the command line as below: xcodes install 13.0

and then it showed cannot find the version of 13

Closes #112

Sometimes it's useful to just download Xcode xip without expanding it. The implemented solution shows progress as: xcodes download 12.0 (1/1) Downloading Xcode 12.0.0: 5 % where 1/6 step indicator is replaced by 1/1 depending on the used command (install vs. download)

When the download is finished, the following message appears: Xcode 12.0.0 has been downloaded to /Users/<#redacted#>/Library/Application Support/com.robotsandpencils.xcodes/Xcode-12.0.0.xip

Flags and arguments are exactly as in "install" command, as such the actual code that creates "install" command is reused for both "download" and "install", and depending on the "shouldInstall" flag, one of two is created with appropriate --help configuration and other strings.

… output

Hi,

Not sure if you'll find this PR useful and corresponding to your philosophy, but anyway...

I find current phrasing Latest non-prerelease version available is... a bit too complex. I would suggest to simplify it by replacing non-prerelease to plain... release.

I see that the same NonPrerelease term is used in variable names. If you find this suggestion feasible, then I can rename variables too.

Maybe you'll tell me that there's some deep idea behind non-prerelease, then I'm fine with that too :)

Thanks for the great tool that saves ton of my time!

hi! first, thanks for this tool – it's much more pleasant to use than navigating through the dev portal to find the latest Xcode update. after having used xcodes several times in the past, i recently encountered an issue that was a bit difficult to diagnose. the setup:

1. i had previously installed Xcode via xcodes with Apple ID $email_1
2. i changed my Apple ID to $email_2
3. i attempted to install a new version of Xcode via xcodes

on step 3, i repeatedly received authentication errors, re-prompting me for my password (which was unchanged), but was not provided any way to re-enter my username (which was now incorrect). after a bit of digging through this repo, i discovered that the 'default' username gets cached in a configuration file for use in subsequent invocations. once i realized this, it was easy enough to fix, but it did take me a while to figure out what was going on.

so, i was wondering if we could add either some improved feedback, perhaps indicating how to override the cached value (it seemed like env variable, or editing the config file would both work), or introduce behavior that will re-prompt for the username in addition to the password based on some criteria.

admittedly, this is likely a very narrow edge-case, since i don't think Apple IDs change that often. still, i'd be willing to try and implement an improvement for this particular snag i hit, time permitting. so, my question is what approach should i pursue to improve this?

Installed formula view homebrew but it's not in the $PATH like the others. I have to manually call /usr/local/Cellar/xcodes/1.2.0/bin/xcodes This might be an issue with the homebrew install script

It would really useful if it were possible to download runtimes without actually installing them. Like we can with Xcode versions.

i.e. xcodes runtimes install "iOS 15.5"

I would imagine this command to mount the DMG and extract the PKG to ~/Downloads.

This pull request prevents the following error when running xcodes runtimes when an "Unknown Platform Simulator" is installed:

Error: keyNotFound(CodingKeys(stringValue: "build", intValue: nil), Swift.DecodingError.Context(codingPath: [_JSONKey(stringValue: "820783CB-C389-4006-B2D2-D063F3FD10A1", intValue: nil)], debugDescription: "No value associated with key CodingKeys(stringValue: \"build\", intValue: nil) (\"build\").", underlyingError: nil))

If one accidentally runs xcrun simctl runtime add with an incompatible pre-iOS 16 Simulator runtime:

xcrun simctl runtime add com.apple.pkg.iPhoneSimulatorSDK15_0-15.0.1.1633542405.dmg

The following error will be displayed:

D: 94DEF0B1-1585-4D71-AB37-98AB08FDD000 <unknown platform> (Unusable - Missing Signature: Error Domain=SimDiskImageErrorDomain Code=3 "Missing Signature" UserInfo={NSLocalizedDescription=Missing Signature, unusableErrorDetail=})

The problem is that it's not immediately obvious that Xcode has still installed the runtime, but with a missing signature state:

And when xcodes runs xcrun simctl runtime list -j, there is no build key resulting in the error:

"820783CB-C389-4006-B2D2-D063F3FD10A1" : {
  "deletable" : true,
  "identifier" : "820783CB-C389-4006-B2D2-D063F3FD10A1",
  "kind" : "Disk Image",
  "path" : "\/Library\/Developer\/CoreSimulator\/Images\/Inbox\/820783CB-C389-4006-B2D2-D063F3FD10A1.dmg",
  "signatureState" : "Missing",
  "sizeBytes" : 5304795932,
  "state" : "Unusable",
  "unusableErrorDetail" : "Error Domain=SimDiskImageErrorDomain Code=3 \"Missing Signature\" UserInfo={NSLocalizedDescription=Missing Signature, unusableErrorDetail=}",
  "unusableErrorMessage" : "Missing Signature",
  "unusableSubstate" : "Missing Signature"
}

This change results in the following xcodes runtimes output:

-- Unknown --
Unknown 0 (Downloaded)

Another approach could be to filter out undecodable runtimes in the RuntimeList class, this actually resulted in more code though.

My AppleID is under Federated Authentication in my company's Business Manager. This means that I cannot login with a standard password and will have to authenticate via Azure AD (OAuth like solution).

Is there any way that I can authenticate, when downloading new versions of Xcode?

I tried to type-in my AppleID and just pressed the "Return" key on the password prompt and got this error:

unexpectedSignInResponse(statusCode: 403, message: Optional("-22320: Federated Authentication is required."))

When using xcodes under a standard user (non-admin), the installation into /Applications will fail.

Downloading with aria2 (/Users/ci/homebrew/bin/aria2c)
(1/6) Downloading Xcode 14.2.0+14C18: 99 %
(2/6) Unarchiving Xcode (This can take a while)
Using regular unxip. Try passing `--experimental-unxip` for a faster unxip process
(3/6) Moving Xcode to /Applications/Xcode-14.2.0.app
“Xcode” couldn’t be moved because you don’t have permission to access “Applications”.

I suggest to ask for the credentials of an admin account and to execute the moving operation under this user.

I have in /Users/******/Library/Application Support/com.robotsandpencils.xcodes:

• Xcode-13.0.0-Beta.4+13A5201i.xip dated 29 JUL 2021, size 10.39GB
• Xcode-beta.app dated 24 JUL 2021, size 16.1GB

xcodes installed
14.2 (14C18) (Selected) /Applications/Xcode.app

I'd like to have option to wipe such files.