source: software-center/trunk/fuentes/README @ 403

Last change on this file since 403 was 401, checked in by mabarracus, 5 years ago

Added 16.01+16.04.20160119 sources

File size: 4.2 KB
Line 
1= User notes =
2
3The software-center application aims to make the software handling on
4the computer easy and consistent.
5
6= Developer notes =
7
8All non UI code must come with tests in the test/ subdirectoy.
9
10To setup your development environment, you'll need to ensure the following
11extra packages are installed:
12
13sudo apt-get install xvfb python-coverage python-mock python3-aptdaemon.test \
14     python-qt4 python-unittest2 python-lxml pep8
15sudo apt-get build-dep software-center
16
17You can then run tests with:
18
19cd test;make
20
21You can run a developer instance with:
22
23python setup.py build
24PYTHONPATH=./build/lib.linux-x86_64-2.7 ./bin/software-center
25(the PYTHONPATH needs to be adjusted depending on the architecture)
26
27The initial launch of this will take a bit as it will build a private
28search database but this is only needed once.
29
30== query parser ==
31
32The query parser understands :
33 "pkg:2vcard", "mime:text/html", "section:web", "origin:main"
34prefixes.
35
36== aptdaemon ==
37 * the dbus limits for the system bus are rather low, this means that
38   adding  <limit name="max_match_rules_per_connection">512</limit>
39   and using something bigger than 512 is a good idea
40
41== environment ==
42
43The following environment variables are supported:
44
45SOFTWARE_CENTER_AGENT_HOST - an alternative host to query for pay software
46SOFTWARE_CENTER_REVIEWS_HOST - an alternative host for the ratings&reviews
47SOFTWARE_CENTER_DEBUG_HTTP - enable httplib2 debuging
48SOFTWARE_CENTER_DEBUG_WEBKIT - enable webkit debuging
49SOFTWARE_CENTER_IPSUM_REVIEWS - generate random reviews
50SOFTWARE_CENTER_FAKE_REVIEW_API - use a fake server for all review network operations
51SOFTWARE_CENTER_AGENT_INCLUDE_QA - show not yet QA apps available from the agent
52SOFTWARE_CENTER_NET_DISCONNECTED - make software-center's netstatus module believe network manager is in a disconnected state
53SOFTWARE_CENTER_WEBLIVE_HOST - overwrite default weblive server
54SOFTWARE_CENTER_DISTRO_CODENAME - overwrite "lsb_release -c -s" output
55SOFTWARE_CENTER_ARCHITECTURE - overwrite the current architecture
56SOFTWARE_CENTER_NO_SC_AGENT - disable the software-center-agent
57SOFTWARE_CENTER_DISABLE_SPAWN_HELPER - disable everything that is run via the "SpawnHelper", i.e. recommender-agent, software-center-agent, reviews
58SOFTWARE_CENTER_DEBUG_TABS - show notebook tabs for debugging
59SOFTWARE_CENTER_FORCE_DISABLE_CERTS_CHECK - disables certificates checking in webkit views (for use in test environments)
60SOFTWARE_CENTER_FORCE_NON_SSL - disable SSL (for use in test environments)
61
62== applications.menu ==
63
64The menu file parser understands:
65Category, And, Or, Not
66
67The following additional XML filters are definied:
68SCType - e.g. "Applicatin"
69SCChannel - e.g. "lucid-partner"
70SCSection - e.g. "net"
71SCPkgname - e.g. "gimp"
72
73Additional .menu files can be added in:
74/usr/share/app-install/menu.d
75that software-center will read and parse.
76
77== XAPIAN ==
78
79The following special prefixes are used:
80
81AA - application name (Abiword)
82AP - package name (abiword)
83AS - archive pocket (main)
84AE - archive section (mail, base, ...)
85AC - category (AudioVideo)
86AM - MimeType (application/x-ogg)
87AT - type (Application)
88AH - channel
89
90
91The following values are used:
92
93XAPIAN_VALUE_PKGNAME - pkgname
94XAPIAN_VALUE_ICON - icon name
95XAPIAN_VALUE_GETTEXT_DOMAIN - gettext domain
96XAPIAN_VALUE_ARCHIVE_SECTION - archive section (main, restricted, universe, multiverse)
97XAPIAN_VALUE_ARCHIVE_ARCH - architectures (seperated with ",", e.g. i386,amd64) - may be empty
98XAPIAN_VALUE_POPCON - popcon data
99XAPIAN_VALUE_SUMMARY - summary text
100XAPIAN_VALUE_DESKTOP_FILE - the desktop file that the information comes from
101XAPIAN_VALUE_PRICE - the price (if its a for-pay app)
102XAPIAN_VALUE_ARCHIVE_CHANNEL - channel (third party)
103XAPIAN_VALUE_ARCHIVE_PPA - the PPA name that the application is in
104XAPIAN_VALUE_ARCHIVE_DEBLINE - a deb line for the sources.list to access the given app
105XAPIAN_VALUE_ARCHIVE_SIGNING_KEYID - signing key id for the repository
106XAPIAN_VALUE_PURCHASED_DATE - the data a for-pay app was purchased (only available after the software-center-agent server was queried)
107XAPIAN_VALUE_SCREENSHOT_URLS - a (optional) list of "," seperated screenshot urls that overrides the default
108XAPIAN_VALUE_ICON_NEEDS_DOWNLOAD - icon needs to be fetched
109XAPIAN_VALUE_THUMBNAIL_URL - thumbnail url
110
Note: See TracBrowser for help on using the repository browser.