From Fedora Project Wiki

(Use Image: to allow wikitext to fetch them)
Line 45: Line 45:
Once you are satisfied with your spec file, make sure to upload/update sources of your package and commit your changes. When this is done, you can push a build to Koji by right-clicking on your spec file => "Fedora Packager" => "Push Build to Koji".
Once you are satisfied with your spec file, make sure to upload/update sources of your package and commit your changes. When this is done, you can push a build to Koji by right-clicking on your spec file => "Fedora Packager" => "Push Build to Koji".


[[File:EclipseFedoraPackagerPushBuildToKoji.jpg]]
[[Image:EclipseFedoraPackagerPushBuildToKoji.jpg]]


Eclipse will pop up a message telling you the Koji URL to track your build.
Eclipse will pop up a message telling you the Koji URL to track your build.

Revision as of 06:57, 22 July 2010

Getting Started

Eclipse Fedora Packager is a plugin for Eclipse which helps Fedora packagers used to IDEs to package their Fedora RPMs from within Eclipse without needing to resort to the command line.

(Some) Basic features:

  • RPM spec file editor with syntax highlighting, auto-completion and changelog (<Ctrl>+<Alt>+c) support
  • Download sources
  • Prepare local builds
  • Create local builds
  • Push build to Koji (automatic tagging if desired)
  • Eclipse CVS support
  • Mock builds
  • Create Bodhi updates
  • and many more :-)

Eclipse Fedora Packager is now available for Fedora users in rawhide. Please try it out :-)

yum install --enablerepo=rawhide eclipse-fedorapackager

Import Fedora CVS Package

Make sure you have run fedora-packager-setup before you start. This you have to do once on the command line (If you have used fedora-cvs before, this is not necessary). Then, you need to get your Fedora CVS module. Go to "File" => "Import" => "CVS" => "Projects from Fedora CVS"

EclipseFedoraPackagerImportFedoraCVS.jpg

After you hit "Next" twice, you are ready to specify the module you'd like to check out.

EclipseFedoraPackagerSpecifyModuleForCheckout.jpg

After you hit "Finish" you should have a new project in Eclipse named after the Fedora CVS module you just checked out. Note: If you click "Next" at this step, checkout will most likely fail. This is a bug (https://fedorahosted.org/eclipse-fedorapackager/ticket/5) we are currently working on.

Do Your Fedora Packaging Work

Inside the newly created project you'll see a rather familiar file structure, such as branches for Fedora releases (e.g. F-13). Inside each branch you are good to work on your spec file.

Using the Spec-File Editor

Eclipse Fedora Packager uses the RPM Editor and ChangeLog plug-in of the Eclipse Linux Tools project (http://www.eclipse.org/linuxtools). For instance you can easily create a new ChangeLog entry in your spec file by using the <CTRL>+<ALT>+C keyboard shortcut (you may want to set appropriate "ChangeLog" preferences first). Using <CTRL>+<SPACE> auto-completes locally installed packages. Also, you can run rpmlint by right-clicking on your spec file => "Run Rpmlint". For more information have a look at the spec file editor screencast: http://www.eclipse.org/downloads/download.php?file=/technology/linuxtools/videos/specfile-demo.ogg

Push Build to Koji

Once you are satisfied with your spec file, make sure to upload/update sources of your package and commit your changes. When this is done, you can push a build to Koji by right-clicking on your spec file => "Fedora Packager" => "Push Build to Koji".

EclipseFedoraPackagerPushBuildToKoji.jpg

Eclipse will pop up a message telling you the Koji URL to track your build.

Reporting Bugs

If you think you've found a bug in Eclipse Fedora Packager, please feel free to open a ticket at: https://fedorahosted.org/eclipse-fedorapackager (you have to log in with your FAS username in order to be able to create tickets). Thanks!