Using Fedora Packager for Eclipse
Getting Started as Maintainer for a New Fedora Package		Feedback/Reporting Bugs

Using Fedora Packager for Eclipse

Before continuing with this part, make sure you have read our initial setup instructions . Moreover, please make sure your FAS SSH keys are properly configured in Eclipse.

Most of the features of Fedora Packager for Eclipse are accessible via its context menu or keyboard short-cuts. The richest context menu is available if you imported a Fedora Git package. A subset of this functionality is also available for Fedora RPM projects. The former is intended for Fedora package maintainers and the latter is useful for creating a new Fedora package, which is not yet part of the Fedora distribution.

Context Menu

The Fedora Packager context menu should be available if you:

1. Right-click on a project which got imported via the Import from Fedora Git wizard or a smaller subset for projects created with the Fedora RPM Project wizard.

2. Right-click on a .spec file which is contained in a Fedora Packager project (e.g. in the Project Explorer).

3. Right-click in the .spec file itself, while editing it.

Available Keyboard Short-Cuts

As of Fedora Packager 0.2 available Fedora Packager for Eclipse actions have corresponding keyboard short-cuts. All available short-cuts are shown if you press CTRL+ALT+F. Note that keyboard short-cuts work on the package which is associated with the currently open .spec file (with the exception of importing a new Fedora Git package, CTRL+ALT+F I.

Fedora Packager for Eclipse Actions

The following table describes all Fedora Packager for Eclipse commands in more detail.

As mentioned earlier, as of Fedora Packager for Eclipse 0.2 there are two options for creating Fedora packaging projects:

1. Importing an existing Fedora Git project. This should be used for package maintenance.

2. Create a new Fedora RPM project for a package not yet in Fedora

First, we'll describe how Fedora Packager for Eclipse can be used for creating a new Fedora package. This is handy if you decided to become a new package maintainer (never packaged something for Fedora before) and would like to submit a package for review. It is also useful for existing package maintainers who would like to introduce a new Fedora package. If you'd like to become a new package maintainer, the Fedora RPM Project option of Fedora Packager for Eclipse 0.2, will help you walking you through the process and will make some parts of it easier for you. For existing packager this will help expediting SRPM creation and submitting it for review.

Creating a Local Fedora RPM Project

{{admon/warning|Note| This option should only be used if the software you'd like to package is not yet part of the Fedora distribution. If it is already part of Fedora, follow instructions here.}}

1. Select New > Fedora > Fedora RPM Project and click Next.

2. Type the name of your desired package name in Project name and click Next.

3. Select the option that matches you:

If you are an Existing maintainer, select this option and click Next.

If you are a New maintainer', make sure you follow all the mentioned steps to complete your account setting. Once you are finished you can type in your FAS Account ID and click Next.

4. You can start the project in three different ways:

4.a. Start a plain project

If you want to upload an existing .spec file, un-check the Generate a .spec file from template option and click Browse to upload your file.

Select your .spec file and click Finish.

If you this project does not have any .spec file yet, leave the Generate a .spec file from template checked and Click Next.

Apply any necessary changes and click Finish.

Your project content and your generated specfile should look like this:

5. At the end of creating the project, you will be asked to open the project in the Fedora Packager Perspective.

Your project will be a local Git repository which has been initialized with the Specfile. The new repository will be automatically opened in the Git Repository View as part of the Fedora Packager Perspective.

4.b. Use existing .spec file and sources by importing SRPM file

If you have already an SRPM, you can upload it to your workspace and the Specfile and sources will be extracted from SRPM.

Select your SRPM file and click Finish.

Your project content and your generated specfile should look like this:

4.c. Create project using Rpm Stubby

If you have an Eclipse-feature or Maven-Pom, you can select first option to start your project using RPM Stubby. From the drop down list:

Select ECLIPSE_FEATURE to upload an existing feature.xml file to your project.

Or select MAVEN_POM to upload an existing pom.xml file to your project.

Select your file and click Finish.

Your project content and your generated Specfile should look like this:

Local Menu

Now, you can use Fedora Packager's context menu From the main Context Menu. Few commands as is shown in this screen-shot are available to the local project to enable you to locally build your package:

Importing a Fedora Git Project

Once you are a sponsored Fedora packager you can import Fedora Git packages as follows. Before doing so make sure you've run fedora-packager-setup and configured your FAS SSH keys in Eclipse.

1. Select Import > Git > Projects from Fedora Git and click Next. Alternatively, you can use the keyboard short-cut CTRL+ALT+F I

2. Type the name of the package in Package name.

You can find screenshots of these steps in Fedora Packager Import Wizard section of this user guide.

3. Once the new project has been created something akin to the following is seen.

In this case, eclipse-fedorapackager refers to the Git repository name and master to the currently checked out branch.

Fedora Packaging Work

After a Fedora Git project has been created, all files required for packaging the desired release can be found in the created Eclipse project directly. For example, files for release Fedora 13 correspond to files present in the Eclipse project, once switched to branch f13. Files in branch master correspond to Fedora rawhide, the current development release of Fedora. All the development should be done in this branch and once it's done you can checkout to another desired branch and rebase that branches on top of master. Then push them together to the upstream.
The following is a brief description of things to consider doing while packaging up some software.

Uploading Source Files Required for a Package

• In order to upload new sources in Fedora Packager for Eclipse, first download upstream sources and place the downloaded sources in the same folder as the Eclipse project. If this is done outside of Eclipse, don't forget to refresh the project afterwards (F5) so that the file actually shows up. A slick way to download sources is to use Specfile Editor functionality directly.
• Once the new source file is available in the project, it can be uploaded to the lookaside cache by right-clicking on your file, Fedora Packager > Upload This File > Replace/Add Existing Sources. This either adds the file to the sources required to build the package or replaces the current content of the sources file to contain a single line with the MD5 sum of the file selected.
• A valid certificate is required to upload to the lookaside cache. If it has expired, a new one can be created by issuing the following command in a terminal:

    $ fedora-cert -n

Downloading Source Files Required for a Package

To download the required source files for an existing package in order to build it:

• Right-click on the .spec file and select Fedora Packager > Download Sources. This downloads all sources listed in the file sources.

Using the Specfile Editor

Fedora Packager for Eclipse uses the RPM Specfile Editor and ChangeLog plug-in from the Eclipse Linux Tools project.
For instance, a new ChangeLog Entry can easily be created in the .spec file by using the Ctrl+Alt+c keyboard shortcut or by clicking Edit > ChangeLog Entry (though a good idea is to set appropriate ChangeLog Preferences first). Also, rpmlint can be run by right-clicking on the .spec file and selecting Run Rpmlint.
For more information have a look at the .spec file editor screen-cast, or at the Specfile Editor User Guide.

Committing Changes to the Local Git Repository

After the .spec file, patches, etc. have been added/changed, commit those changes to the repository. This is done by:

1. Selecting the files to commit (alternatively select the Fedora Git project and select desired unstaged files when the commit dialog is shown)
2. Right-click, Team > Commit...
   
   

Switching Branches (Git Checkout)

Switching branches is as easy as double-clicking on the desired local branch to be worked on.

• The currently checked-out branch is indicated to the left of the project name.
• Make sure to commit, revert, or stash changes before switching to a different branch.
• Refer to the Git and EGit documentation for more information on this.

Building the Package Locally

Preparing Sources for Build

Fedora Packager for Eclipse will download and prepare sources for building a package.

• Select your .spec file, right-click, Fedora Packager > Prepare Sources for Build.

Building RPM for a Local Architecture

This is a great way to test if the .spec file actually builds at all. Once the RPM has been successfully built locally, it is recommended further testing be carried out on the .spec file by completing a build in a chroot environment using mock. Both ways are supported by Fedora Packager for Eclipse.

• To build the RPM locally right-click on the .spec file and select Fedora Packager > Build for Local Architecture. Output of the RPM build process will appear in the Eclipse Console view.

Using mock to build your package is a great way to verify that you have the correct BuildRequires in a .spec file.

• To build the RPM locally using mock, right-click on the .spec file and select Fedora Packager > Local Build Using Mock. Be aware that this may take a long time and requires the mock package to be installed. Use Eclipse's Run in Background functionality for convenience.

Make Locally Committed Changes Public (Git Push)

When you are satisfied with your locally-committed changes, you are ready to publish them publicly. Remember, if you made any mistake in your commits, Git allows history to be rewritten before changes are made public. See the Git and EGit documentation for more information.
To bring the local repository in sync with the remote repository (which is by default called origin):

1. Right-click on the Fedora Git project, click Team > Remote > Push...

2. Select the Git repository to which you would like to push (usually this is kept unchanged), click Next.

5. Select the Git references to push.

In this example, branches master and f14/master will get pushed. Keep in mind that source and destination references are the same for Fedora Packager for Eclipse.

Clicking the Add all branches spec button is a convenience way that pushes all commits to all local branches.

4. Carry out the push operation

Pushing a Build to Koji

As of Fedora Packager for Eclipse 0.2 there are three different options of pushing a build to Koji.

1. Pushing a regular build

2. Pushing a scratch build (using sources from Git and lookaside cache)

3. Pushing a scratch build for which the user provides the SRPM

Using the former two is straight forward. Just keep in mind to Git-push local changes before your trigger either one of the two.

The third option works a bit differently, so we'll focus on it. Pushing a scratch build for which the user specifies the SRPM works as follows:

1. It checks if an SRPM is present in the current project. If so you can select either one of them and use that for the Koji build.

2. If Fedora Packager for Eclipse can't find an SRPM, it will pop up a file selection dialog so that you can browse to and select any SRPM on your filesystem

3. Once the SRPM has been specified, Fedora Packager for Eclipse will upload this SRPM to Koji and Koji will in turn use that SRPM for the build. It won't use any other sources for the build.

After either one of the three Koji builds has been triggered, Eclipse will pop up a message dialog containing the Koji URL to track the pushed build. Here is an example of how the message may look:

Also note that there will be a log entry in the Eclipse Error Log view detailing the Koji-Web URL of the pushed task as well. If you click on the provided URL, a browser tab will open in Eclipse showing you the status of the pushed build. Refresh it in order to follow build progress. As of yet, Fedora Packager for Eclipse does not support chain builds.

Pushing a Bodhi Update

Fedora Packager for Eclipse can be used to push Bodhi updates as well. For example you can use keyboard short-cut CTRL+ALT+F B or the context menu to trigger this action ( Fedora Packager > Create New Bodhi Update). Before you push a Bodhi update, make sure that all relevant builds have been pushed to Koji. If you attempt to push an update for a build which does not exist, the Bodhi update will fail. The recommended steps prior pushing a Bodhi update are:

1. Push build to Koji

2. Make sure your local .spec file matches what's in the remote Git repository

3. Right-click on the .spec file of the package you'd like to push an update for

After step three the following actions are carried out by the Bodhi update action of Fedora Packager for Eclipse:

1. Fedora Packager for Eclipse (FP for short) checks for unpushed changes of the current branch.

2. FP will try to restore saved username and password from Eclipse's secure storage and might therefore prompt for the master password of the secure storage. This only happens if the user ever checked the saved password checkbox of the Bodhi login dialog.

3. FP will ask for your Bodhi credentials (your FAS username and password).

4. FP will validate credentials before presenting the update dialog.

5. FP shows the Bodhi update dialog as shown below.

Arbitrary additional builds may be added to the list of builds via the Add Builds button.

In order to push the update select relevant builds in the dialog (use CTRL+Click to select multiple builds) you'd like to push an update for, choose the update type, provide the request type, add an advisory comment for the update and click Save Update. If the Bodhi update was successfully pushed, Fedora Packager for Eclipse will show you a message dialog with a link to an URL where the progress of the update can be tracked.

Configure SSH in Eclipse

Before you get started with importing packages from Fedora Git, you should have your FAS SSH keys set up in Eclipse. You should do this because if Fedora Packager for Eclipse finds a ~/.fedora.cert file, it will use an SSH based clone URL with your FAS username extracted from this certificate. Note that you'll have the option of cloning anonymously anyway.

Unfortunately, Eclipse can't use your ssh-agent. Our believe is that this is because Eclipse has to run on several platforms (not just Eclipse). Since UNIX sockets are platform dependent, this may be be reason why Eclipse can't use it.

Eclipse SSH Preferences

Press CTRL+3, type "SSH2" and hit return. This should bring you to the following page:

Make sure that your FAS SSH key is listed there and you can successfully unlock your key.

Getting Started as Maintainer for a New Fedora Package		Feedback/Reporting Bugs