From Fedora Project Wiki

(Getting Started)
(Use Image: to allow wikitext to fetch them)
Line 25: Line 25:
 
Make sure you have run <code>fedora-packager-setup</code> 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"  
 
Make sure you have run <code>fedora-packager-setup</code> 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"  
  
[[File:EclipseFedoraPackagerImportFedoraCVS.jpg]]
+
[[Image:EclipseFedoraPackagerImportFedoraCVS.jpg]]
  
 
After you hit "Next" '''twice''', you are ready to specify the module you'd like to check out.
 
After you hit "Next" '''twice''', you are ready to specify the module you'd like to check out.
  
[[File:EclipseFedoraPackagerSpecifyModuleForCheckout.jpg]]
+
[[Image: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.
 
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.

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!