DRAFT
THIS DOCUMENT IS A WORK IN PROGRESS. DO NOT RELY UPON IT, FOR IT WILL EAT YOUR BABIES.
Introduction
This is a simple, step-by-step lesson plan for becoming an effective Sugar activities packager for Fedora. There are a lot of steps involved, which makes the process look intimidating -- but really, it's pretty simple, and this lesson plan will take you through it. Follow these steps and you'll be an ace packager in no time at all.
We assume basic familiarity with Linux, understand how to install and uninstall RPM packages, familiarity with command-line usage, and basic scripting, programming, and sysadmin skills.
Background Reading
Estimated time: 30 minutes
It's a really great idea to read through the Creating a Package Howto before you get started. It's a big document, but that's okay; read through it once to get familiar with the ideas, and then we'll go through everything step by step here.
Packaging Your First Sugar Activity
LESSON 1: Setting Up Your System
Estimated time: 15 minutes
In order to create an RPM package, it's customary to set up a separate user on your Linux system called "makerpm", and then configuring an RPM build environment in that user's home directory. Instructions on how do that that can be found in the Creating a Package Howto.
Go follow those instructions now. When you're done, you should have a user named makerpm with a directory in your homedir named rpmbuild that looks something like this:
[makerpm@localhost rpmbuild]$ pwd
/home/makerpm/rpmbuild
[makerpm@localhost rpmbuild]$ ls
BUILD RPMS SOURCES SPECS SRPMS
LESSON: Creating a Package
Let's start by packaging a Sugar activity that has already been packaged. That way, we can compare your package to the end result, and see how well we did.
HOMEWORK: Creating a Package
Now that you've been through