Activity Team/Activity Development Fedora 17

From Sugar Labs
< Activity Team
Revision as of 00:13, 6 June 2012 by FGrose (talk | contribs) (approximate XO screen size proportions)
Jump to navigation Jump to search

Develop an Activity under Fedora 17

Developing an activity under Fedora has never been so easy. Here are the most basic steps to get you started.

Install Fedora 17

Follow the instructions at the Fedora page and install Fedora or run it in a virtualized environment.

Install Sugar

Now install Sugar: 

yum groupinstall sugar-desktop

For running Sugar under GNOME you can use the 'sugar-emulator' install the package: 

yum install sugar-emulator

Start the sugar emulator

You can start the Sugar emulator from the terminal, like: 

sugar-emulator

To approximate the screen size proportions of an XO: 

sugar-emulator -i 832x624

Or you can run it from your launcher like any other application: 

sed -i 's/sugar-emulator/& -i 832x624/' /usr/share/applications/sugar-emulator.desktop

or in the Nautilus graphical file browser,

right click the Sugar entry in /usr/share/applications/,
click the 'Properties' menu item,
and add -i 832x624 to the 'Command:' entry box.

(Note: The images below were taken with the default 800x600 resolution of Sugar in a window.)

1 develop activity f17 start sugar emulator.png

2 develop activity f17 running emulator.png

3 develop activity f17 running emulator 3.png

Modify an Activity

The Activities you installed earlier with the 'groupinstall' command are installed under '/usr/share/sugar/activities/'. For developing it is easier to have them available in a user accessible part of the system. Sugar does look in the $HOME/Activities folder for Activities. The folder has to be named to end with '.activity'.

Start a terminal and create the folder in your $HOME directory and change into it: 

cd
mkdir Activities
cd Activities/

Clone the HelloWorld activity (in the folder helloworld.activity): 

git clone git://git.sugarlabs.org/hello-world/mainline.git helloworld.activity

6 develop activity f17 get helloworld.png


If you know restart the sugar-emulator the activity will be available. You can favorite it in the activity-list view in the Home view.


7 develop activity f17 helloworld favorite.png


8 develop activity f17 helloworld favorte 2.png


9 develop activity f17 helloworld favorite 3.png


10 develop activity f17 run helloworld.png


So the first fun thing to do is to change the HelloWorld Activity to welcome yourself. Just change the activity.py file in the Activity folder with your favorite editor and restart the Activity. You do not need to restart the emulator for that.

11 develop activity f17 edit activity 1.png


12 develop activity f17 edit activity.png


13 develop activity f17 result.png


If you made it that far yo have been made a big step to become an Activity developer using the tools available in Fedora 17. I hope you enjoyed it.

Retrieved from "https://wiki.sugarlabs.org/index.php?title=Activity_Team/Activity_Development_Fedora_17&oldid=79044"