Skip to content
pubscout

xcode_parser

2.1.0, released 8 months ago by an unverified publisher

Read, modify, and save Xcode project .pbxproj files programmatically

WASM-ready
$ flutter pub add xcode_parser
Source repository

What it does

Reads and analyzes the contents of Xcode .pbxproj project files, allows modifying settings and configurations, and saves the changes back out. It supports native platforms as well as web and WASM via string parsing.

AI-written summary of version 2.1.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to automate iOS development or build tasks by modifying Xcode project settings.
  • You want to programmatically inject build configurations or source files into a .pbxproj file.

Skip it when

  • You are building a standard mobile application that does not require low-level project file modification.
  • You need deep native device access outside of parsing text-based Xcode project structures.

Strengths

  • Compatible with native platforms, Web, and WASM.
  • Provides an intuitive object-oriented representation of sections, maps, entries, and lists inside .pbxproj files.

Weaknesses

  • Opening large project files can take a few seconds and requires isolates to avoid blocking the main thread.
  • File reading and writing methods throw UnsupportedError on Web and WASM platforms.

Setup

Kind
Pure Dart
Effort
Low
Code generation
No
Direct dependencies
1
void main() async {
  var project = await Pbxproj.open('path/to/Runner.xcodeproj/project.pbxproj');
  var uuid = project.generateUuid();
  var config = MapPbx(
    uuid: uuid,
    children: [
      MapEntryPbx('isa', VarPbx('XCBuildConfiguration')),
      MapEntryPbx('name', VarPbx('"CustomDebug"')),
    ],
  );
  project.add(config);
  await project.save();
}

Alternatives

Packages that do the same job and could replace xcode_parser.