jazzy icon indicating copy to clipboard operation
jazzy copied to clipboard

Cannot Execute Jazzy that's installed using Bundler on XCode 15.2

Open hilmyveradin opened this issue 1 year ago • 3 comments

I worked on OSS repo which using jazzy as it's documentation. However, the jazzy script is not recognizable as command and when I run bundle exec jazzy, it fails. Few things:

  1. I'm using XCode 15.2
  2. I'm using Ruby version 3.2.2
  3. Jazzy already included in Gemfile.lock. It even already included in the vendor/bin/ruby file (see first image)
  4. It appears there's error like the second image
  5. When traced, it has something to do with "file exists but not in directory"

Any idea why?

image image image

hilmyveradin avatar Apr 24 '24 12:04 hilmyveradin

That's an error from xcodebuild -- it happens if you have a file called build from your project where xcodebuild itself wants to create a build directory.

johnfairh avatar Apr 24 '24 14:04 johnfairh

I see. But it's expected for the project to be built in order to jazzy to generate documentation right? Or it's not?

I'm kind of confused on how to address this root cause, to be honest

hilmyveradin avatar Apr 26 '24 03:04 hilmyveradin

Yes, jazzy runs xcodebuild as part of generating documentation.

You haven't said if you have found a possible build file in your project that is breaking things?

You can either rename that file or maybe look at changing xcodebuild's build directory by passing it -derivedDataDir (see man xcodebuild).

johnfairh avatar Apr 26 '24 08:04 johnfairh

Closing, answered.

johnfairh avatar May 22 '24 08:05 johnfairh