Unity

Differences between revisions 8 and 37 (spanning 29 versions)
Revision 8 as of 2010-06-15 19:32:15
Size: 2484
Editor: c-76-112-209-61
Comment:
Revision 37 as of 2011-03-07 16:55:43
Size: 3151
Editor: c-67-174-110-114
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from DesktopTeam/Unity
Line 3: Line 4:
= Unity = ##= Unity = H1/titles are redundant in the Ubuntu Wiki. This is already the page name and will be rendered as the top-most H1 as a result. (Note that it won't show up on the preview, but will after you save.)
Line 5: Line 6:
Unity is the default UI for Ubuntu Netbook Edition in 10.10. It's a step forward in the Netbook Edition, making it easy and well-fitted for those screen sizes for your a desktop environment. More information on Unity is available on [[http://www.markshuttleworth.com/archives/383|sabdfl's blog]]. The wiki documentation is targeting technical users, if you want to get an overview of Unity you might be interested ready those:
Line 7: Line 8:
= How to test Unity =  * [[http://unity.ubuntu.com|Unity Homepage]]
 * [[attachment:Unity_Architecture.pdf|Unity Architecture]]
 * [[Unity/Bitesize|Unity Bitesize Bugs]] - A great place for new hackers to contribute improvements and fixes.
 * [[Unity/CodingStyle|Coding Style Guidelines]]
 * [[Unity/LauncherAPI|Launcher Integration]] - For application developers that want to add progress bars and other "overlays" onto their icon in the Unity Launcher
Line 9: Line 14:
== On Maverick (10.10) ==
Line 11: Line 15:
=== on UNE edition === = How to test Unity 3.0 (compiz based) =
Line 13: Line 17:
Unity is the default UI for Ubuntu Netbook Edition on 10.10. The easiest way to test it is to install the Netbook Edition of the 10.10 development cycle from the daily built iso [[http://cdimage.ubuntu.com/ubuntu-netbook/daily-live/current/|available here]] or use [[https://edge.launchpad.net/testdrive|testdrive]]. This section documents how you can try out Unity 3.0 on your Ubuntu system.
Line 15: Line 19:
=== with a standard ubuntu-desktop edition ===  * How to make a [[Unity/InstallUSBKey|persistent USB Key]] for Unity Testing.
Line 17: Line 21:
 1. Run just `sudo apt-get install ubuntu-netbook`
 1. This will add in GDM a "Ubuntu Netbook Edition" menu option when you click on your username. Select it and login to get the Unity interface.
||<style="background:Orange">Note: This software is alpha. We recommend not trying this on a production machine, make a dedicated USB stick (see above)||
Line 20: Line 23:
=== Update frequence === == Limitations and Tips ==
Line 22: Line 25:
Unity is released weekly, right into Maverick and then into the Lucid PPA. Stay tuned!  * This version of Unity does NOT have Places or the Dash, these will come back for Alpha 2.
 * For now, be sure to use Humanity or Humanity-Dark icon themes. Others will cause Unity 3.0 alpha to crash.
Line 24: Line 28:
== on lucid (10.04 LTS) == == Natty ==
Line 26: Line 30:
Unity is primarily built for maverick (10.10), but we are conscious that some people want to test it on lucid. For those, we have setup a PPA and backport unity component to lucid. Unity is the default interface in Natty. You have two sessions in GDM:
Line 28: Line 32:
||<style="background:Peru">Note: The Unity PPA brings in some lower level components that we need like a new GTK and some new libraries. You should be comfortable with being able to downgrade multiple pages if you want to go back to a stable Lucid, otherwise we recommend a virtualization tool like [[http://launchpad.net/testdrive|testdrive]] to test Unity.||  * Ubuntu Desktop Edition (which has Unity by default)
 * Ubuntu Classic Desktop (which run the previous Ubuntu interface)
Line 30: Line 35:
 1. If you are on Lucid, load a terminal and run `sudo add-apt-repository ppa:canonical-dx-team/une` and `sudo apt-get update`.
 1. Run `sudo apt-get install ubuntu-netbook-unity-default-settings`.
 1. Logout and choose in GDM your "Ubuntu Unity Netbook Edition" menu option when you click on your username
[[https://wiki.ubuntu.com/Unity/InstallationGuideFromSource|Building Unity from Source]] - For developers
Line 34: Line 37:
== is there a difference from the maverick version? == == How and where to file bugs ==
Line 36: Line 39:
Apart from the fact we have a different session name "Unity" instead of "UNE" and a fake metapackage "ubuntu-netbook-unity-default-settings", the behavior is the same. The only other difference is that you still can have netbook-launcher (the 10.04 LTS UNE interface) in a parallel install than Unity. === Crash bugs ===
For Alpha 1, the most valuable bug reports are crash reports.
Line 38: Line 42:
= Filing Bugs = After installing, enable apport: edit /etc/default/apport, set enabled=1 and restart you computer. Once activated the system should detect crashes and prompt you to report those.
Line 40: Line 44:
You should file bugs against [[http://bugs.launchpad.net/unity|Unity]] in Launchpad. === Non crash bugs ===

The best way to log a bug is to use this command:

{{{
ubuntu-bug unity
}}}

It will collect the required details and send you to launchpad to write your bug description.

(If you build Unity from source or want to open a bug without using ubuntu-bug please follow [[UnityFilingBugs|this guide]])

=== Window matching problems ===

If you notice a problem with an application icon in the launcher (blurry icon, pinning not working, etc.), Unity is probably having some problems matching the window to the correct .desktop file. Please edit [[https://wiki.ubuntu.com/Unity/WindowMatching|this wiki page]] with the details of any problems of this kind you find.

== How to Contribute to Unity ==

http://unity.ubuntu.com/getinvolved/ has instructions on how to get the code and hack on it.

== Support ==

 * Please consult the [[DesktopExperienceTeam/UnityHardwareRequirements|Hardware Requirements for Unity]].
 * To report bugs: see [[UnityFilingBugs]]

----
CategoryDocumentation CategoryDocteam

The wiki documentation is targeting technical users, if you want to get an overview of Unity you might be interested ready those:

How to test Unity 3.0 (compiz based)

This section documents how you can try out Unity 3.0 on your Ubuntu system.

Note: This software is alpha. We recommend not trying this on a production machine, make a dedicated USB stick (see above)

Limitations and Tips

  • This version of Unity does NOT have Places or the Dash, these will come back for Alpha 2.
  • For now, be sure to use Humanity or Humanity-Dark icon themes. Others will cause Unity 3.0 alpha to crash.

Natty

Unity is the default interface in Natty. You have two sessions in GDM:

  • Ubuntu Desktop Edition (which has Unity by default)
  • Ubuntu Classic Desktop (which run the previous Ubuntu interface)

Building Unity from Source - For developers

How and where to file bugs

Crash bugs

For Alpha 1, the most valuable bug reports are crash reports.

After installing, enable apport: edit /etc/default/apport, set enabled=1 and restart you computer. Once activated the system should detect crashes and prompt you to report those.

Non crash bugs

The best way to log a bug is to use this command:

ubuntu-bug unity

It will collect the required details and send you to launchpad to write your bug description.

(If you build Unity from source or want to open a bug without using ubuntu-bug please follow this guide)

Window matching problems

If you notice a problem with an application icon in the launcher (blurry icon, pinning not working, etc.), Unity is probably having some problems matching the window to the correct .desktop file. Please edit this wiki page with the details of any problems of this kind you find.

How to Contribute to Unity

http://unity.ubuntu.com/getinvolved/ has instructions on how to get the code and hack on it.

Support


CategoryDocumentation CategoryDocteam

Unity (last edited 2014-01-21 18:49:47 by 3v1n0)