Xcode Question posted in
Whether you're new to Xcode or an experienced developer, our archive has everything you need to know about this integrated development environment (IDE). From basic functionalities to advanced features, our archive covers a wide range of Xcode-related questions and answers. Browse our archive now and find solutions to your Xcode questions, and take your app development skills to the next level

Swift: Jazzy failing to run xcodebuild

I’m trying to generate some documentation for. my project using Jazzy. However, when I run jazzy from the command line I’m getting the following output:

Could not successfully run `xcodebuild`.
Please check the build arguments.
Saved `xcodebuild` log file: /var/folders/nd/t1rlxsp94kgbll0v834jnc0h0000gp/T/xcodebuild-84D58051-E84E-40D8-A4E7-E080B83D7117.log
Failed to generate documentation
Traceback (most recent call last):
    7: from /usr/local/bin/jazzy:23:in `<main>'
    6: from /usr/local/bin/jazzy:23:in `load'
    5: from /usr/local/lib/ruby/gems/2.7.0/gems/jazzy-0.13.6/bin/jazzy:15:in `<top (required)>'
    4: from /usr/local/lib/ruby/gems/2.7.0/gems/jazzy-0.13.6/lib/jazzy/doc_builder.rb:79:in `build'
    3: from /usr/local/lib/ruby/gems/2.7.0/gems/jazzy-0.13.6/lib/jazzy/doc_builder.rb:79:in `chdir'
    2: from /usr/local/lib/ruby/gems/2.7.0/gems/jazzy-0.13.6/lib/jazzy/doc_builder.rb:81:in `block in build'
    1: from /usr/local/lib/ruby/gems/2.7.0/gems/jazzy-0.13.6/lib/jazzy/sourcekitten.rb:266:in `run_sourcekitten'
/usr/local/lib/ruby/gems/2.7.0/gems/jazzy-0.13.6/lib/jazzy/executable.rb:36:in `execute_command': /usr/local/lib/ruby/gems/2.7.0/gems/jazzy-0.13.6/bin/sourcekitten ["doc", "--"] (RuntimeError)

Running xcodebuild

Could not successfully run `xcodebuild`.

Please check the build arguments.

Saved `xcodebuild` log file: /var/folders/nd/t1rlxsp94kgbll0v834jnc0h0000gp/T/xcodebuild-84D58051-E84E-40D8-A4E7-E080B83D7117.log

Failed to generate documentation

Why is this failing to run when from xcode my project build with no issues

Tags:

4

Answers


  1. 0

    Jazzy requires a build from the command line to generate the documentation. So you need a command similar to:

    jazzy --build-tool-arguments -workspace,ios.xcworkspace,-scheme,iosapp

    From https://github.com/realm/jazzy

    …try passing extra arguments to xcodebuild, for example jazzy --build-tool-arguments -scheme,MyScheme,-target,MyTarget

    How to find your schemes and targets to pass into xcodebuild from Jazzy

    Be sure to cd to the directory where your Xcode Workspace or Xcode Project is:
    cd path/to/ios.xcworkspace

    xcodebuild -version

# online help
man xcodebuild

# List schemes & targets
xcodebuild -list

    Results for a sample Xcode Workspace,

    Information about project "ios":
    Targets:
        iosapp
        bench
        dynamic
        static
        bundle
        test
        integration
        Integration Test Harness

    Build Configurations:
        Debug
        Release
        RelWithDebInfo

    If no build configuration is specified and -scheme is not passed then "RelWithDebInfo" is used.

    Schemes:
        bench
        bundle
        CI
        dynamic
        dynamic+static
        Integration Test Harness
        iosapp
        static
    Login or Signup to reply.
  2. 0

    You can review the content of

    log file: /var/folders/nd/t1rlxsp94kgbll0v834jnc0h0000gp/T/xcodebuild-84D58051-E84E-40D8-A4E7-E080B83D7117.log

    for to obtain details the error

    Login or Signup to reply.
  3. 0

    Typically, one of two things go wrong when running Jazzy for the first time. Either you did not set xcodebuild to use the full Xcode app instead of the pure command line tools or you forgot to specify the workspace or scheme in the parameters. This is particularly the case when using Cocoapods or if you have multiple schemes.

    With at minimum these parameters, Jazzy should run in most cases:

    cd yourAppDirectory # the one with the xcodeproj / xcworkspace in it
jazzy --clean --author "Johnny Appleseed" --author_url https://siriuscybernetics.com -x -workspace,DemoApp.xcworkspace,-scheme,DemoAppScheme

    Also consider that that there may be incompatibilities with Apple Silicon / M1 for a while still, such as this Bus Error topic.

    Login or Signup to reply.
  4. 0

    It worked with me! after removing ALL project source code files and clone the repo again! 🙂

    Login or Signup to reply.
Please signup or login to give your own answer.

Back To Top
Search