Apper: Difference between revisions

From KDE UserBase Wiki
m (fix labels)
m (file -> package and reorder the option as they as displayed)
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages />
<languages />


<translate>
<!--T:1-->
{|class="tablecenter vertical-centered"
{|class="tablecenter vertical-centered"
|[[Image:Apper-window.png|250px|thumb|<translate><!--T:28-->
|[[Image:Apper-window.png|250px|thumb|Click to enlarge]]
Click to enlarge</translate>]]<translate>||<!--T:1-->
|'''A graphical tool to manage your packages'''
'''A graphical tool to manage your packages'''</translate>
|}
|}
<translate>


== Features == <!--T:1-->
== Features == <!--T:2-->  


<!--T:2-->
<!--T:3-->
* Manages installation and uninstallation of packages
* Manages installation and uninstallation of packages


<!--T:4-->
* Manages package updates
* Manages package updates


<!--T:5-->
* Can be searched by package-name, description, or included file name
* Can be searched by package-name, description, or included file name


<!--T:6-->
* Supports filtering on</translate>
* Supports filtering on</translate>
<translate>
<translate>
<!--T:7-->
** Installed or available</translate>
** Installed or available</translate>
<translate>
<translate>
<!--T:8-->
** End-user or development
** End-user or development


<!--T:9-->
* Can be viewed in package groups
* Can be viewed in package groups


== Installing packages == <!--T:3-->
== Installing packages == <!--T:10-->


<!--T:4-->
<!--T:11-->
If you know the name of the package, you can simply type that into the ''search bar'' - the default is to find by name.
If you know the name of the package, you can simply type that into the ''search bar'' - the default is to find by name.


<!--T:5-->
<!--T:12-->
{{Note|Searches are slow, as the package database has to be queried - both your local one and the database of each repo.  You will find that working while it does that is slow.}}
{{Note|Searches are slow, as the package database has to be queried - both your local one and the database of each repo.  You will find that working while it does that is slow.}}


<!--T:6-->
<!--T:13-->
Suppose, though, you need suggestions for suitable packages.  This time you would choose to <menuchoice>Find by Description</menuchoice>.  For instance, entering "flac" into the search term then selecting <menuchoice>Find by Description</menuchoice> you would be presented with all packages that are related to the use of flac files. Installed packages are marked by a {{Icon|dialog-ok-apply}} to the left of the package name.
Suppose, though, you need suggestions for suitable packages.  This time you would choose to <menuchoice>Find by Description</menuchoice>.  For instance, entering "flac" into the search term then selecting <menuchoice>Find by Description</menuchoice> you would be presented with all packages that are related to the use of flac files. Installed packages are marked by a {{Icon|dialog-ok-apply}} to the left of the package name.


<!--T:7-->
<!--T:14-->
[[Image:Apper-window1.png|250px|thumb|center|Apper's main window showing a description of the selected package]]
[[Image:Apper-window1.png|250px|thumb|center|Apper's main window showing a description of the selected package]]


<!--T:8-->
<!--T:15-->
So - you have a list of suitable files.  Click on one of them and a panel opens giving you a description of the file. Clicking the <menuchoice>More...</menuchoice> you get three other options to display - a list of files included in the package, a list of dependencies (which will be automatically handled if you choose to install) and a list of applications that depend upon the package you choose.
So - you have a list of suitable packages.  Click on one of them and a panel opens giving you a description of the package. Clicking the <menuchoice>More...</menuchoice> button you get three other options to display - a list of dependencies (which will be automatically handled if you choose to install), a list of applications that depend upon the package you choose and a list of files included in the package.


<!--T:9-->
<!--T:16-->
[[Image:Apper-window2.png|250px|thumb|center|Apper's main window showing package dependencies]]
[[Image:Apper-window2.png|250px|thumb|center|Apper's main window showing package dependencies]]


<!--T:10-->
<!--T:17-->
When you click on a package a button turns up to the right of it. If the package is not installed already you will see an <menuchoice>Install</menuchoice> button; clicking it will mark the package for installation. If the pagkage is already installed you will see a <menuchoice>Remove</menuchoice> button; clicking it will mark the package for removal.
When you click on a package a button turns up to the right of it. If the package is not installed already you will see an <menuchoice>Install</menuchoice> button; clicking it will mark the package for installation. If the package is already installed you will see a <menuchoice>Remove</menuchoice> button; clicking it will mark the package for removal.


<!--T:11-->
<!--T:18-->
Having found the application that is best for you, click the <menuchoice>Install</menuchoice> button. Now, when you click the <menuchoice>Apply</menuchoice> button your package will be installed.
Having found the application that is best for you, click the <menuchoice>Install</menuchoice> button. Now, when you click the <menuchoice>Apply</menuchoice> button your package will be installed.


== Updating your packages == <!--T:12-->
== Updating your packages == <!--T:19-->


<!--T:13-->
<!--T:20-->
On '''Apper's''' main page you click the <menuchoice>Updates</menuchoice> icon to open the settings page to check, if any package installed by '''Apper''' needs updating. As before, the ''repos'' and your installation are queried, so there is a delay. Again, dependencies are resolved when you agree to the download.
On '''Apper's''' main page you click the <menuchoice>Updates</menuchoice> icon to open the settings page to check, if any package installed by '''Apper''' needs updating. As before, the ''repos'' and your installation are queried, so there is a delay. Again, dependencies are resolved when you agree to the download.


== Configuration Options == <!--T:14-->
== Configuration Options == <!--T:21-->


<!--T:15-->
<!--T:22-->
On '''Apper's''' main page you click the {{Icon|settings-menu}} and select <menuchoice>Settings</menuchoice> to open the '''Apper''' settings page.
On '''Apper's''' main page you click the {{Icon|settings-menu}} icon and select <menuchoice>Settings</menuchoice> to open the '''Apper''' settings page.


<!--T:16-->
<!--T:23-->
[[Image:Apper-settings1.png|300px|thumb|center|The General Settings Page]]
[[Image:Apper-settings1.png|300px|thumb|center|The General Settings Page]]


<!--T:17-->
<!--T:24-->
In the <menuchoice>General settings</menuchoice> you can set the frequency of checking for updates, according to your need.  The default is <menuchoice>Daily</menuchoice>, but for an ultra-secure site you could choose <menuchoice>Hourly</menuchoice>, and for a lightly used one you can have <menuchoice>Weekly</menuchoice> or <menuchoice>Monthly</menuchoice> frequency.
In the <menuchoice>General settings</menuchoice> tab you can set the frequency of checking for updates, according to your need.  The default is <menuchoice>Daily</menuchoice>, but for an ultra-secure site you could choose <menuchoice>Hourly</menuchoice>, and for a lightly used one you can have <menuchoice>Weekly</menuchoice> or <menuchoice>Monthly</menuchoice> frequency.


<!--T:18-->
<!--T:25-->
Next is whether you want updates to be installed automatically.  A nice touch is to be able to say that security updates should be automatically installed, but no other packages.
Next is whether you want updates to be installed automatically.  A nice touch is to be able to say that security updates should be automatically installed, but no other packages.


<!--T:19-->
<!--T:26-->
{{Note|1=In the <menuchoice>Software Origins</menuchoice> tab you can configure the repositories used by '''Apper'''. More information on this tab is needed.}}
{{Note|1=In the <menuchoice>Software Origins</menuchoice> tab you can configure the repositories used by '''Apper'''. More information on this tab is needed.}}


<!--T:20-->
<!--T:27-->
[[Image:Apper-settings2.png|300px|thumb|center|The Software Origins page]]
[[Image:Apper-settings2.png|300px|thumb|center|The Software Origins page]]


<!--T:21-->
<!--T:28-->
[[Category:System]]
[[Category:System]]
[[Category:Needs work]]
[[Category:Needs work]] <!-- Should not be translated-->
</translate>
</translate>

Latest revision as of 20:37, 7 January 2019

Click to enlarge
A graphical tool to manage your packages

Features

  • Manages installation and uninstallation of packages
  • Manages package updates
  • Can be searched by package-name, description, or included file name
  • Supports filtering on
    • Installed or available
    • End-user or development
  • Can be viewed in package groups

Installing packages

If you know the name of the package, you can simply type that into the search bar - the default is to find by name.

Note

Searches are slow, as the package database has to be queried - both your local one and the database of each repo. You will find that working while it does that is slow.


Suppose, though, you need suggestions for suitable packages. This time you would choose to Find by Description. For instance, entering "flac" into the search term then selecting Find by Description you would be presented with all packages that are related to the use of flac files. Installed packages are marked by a to the left of the package name.

Apper's main window showing a description of the selected package

So - you have a list of suitable packages. Click on one of them and a panel opens giving you a description of the package. Clicking the More... button you get three other options to display - a list of dependencies (which will be automatically handled if you choose to install), a list of applications that depend upon the package you choose and a list of files included in the package.

Apper's main window showing package dependencies

When you click on a package a button turns up to the right of it. If the package is not installed already you will see an Install button; clicking it will mark the package for installation. If the package is already installed you will see a Remove button; clicking it will mark the package for removal.

Having found the application that is best for you, click the Install button. Now, when you click the Apply button your package will be installed.

Updating your packages

On Apper's main page you click the Updates icon to open the settings page to check, if any package installed by Apper needs updating. As before, the repos and your installation are queried, so there is a delay. Again, dependencies are resolved when you agree to the download.

Configuration Options

On Apper's main page you click the icon and select Settings to open the Apper settings page.

The General Settings Page

In the General settings tab you can set the frequency of checking for updates, according to your need. The default is Daily, but for an ultra-secure site you could choose Hourly, and for a lightly used one you can have Weekly or Monthly frequency.

Next is whether you want updates to be installed automatically. A nice touch is to be able to say that security updates should be automatically installed, but no other packages.

Note

In the Software Origins tab you can configure the repositories used by Apper. More information on this tab is needed.


The Software Origins page