xref: /OK3568_Linux_fs/yocto/meta-browser/meta-firefox/README.md (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunOpenEmbedded/Yocto BSP layer for Firefox Browser
2*4882a593Smuzhiyun================================================
3*4882a593Smuzhiyun
4*4882a593SmuzhiyunThis layer provides web browser recipes for use with OpenEmbedded
5*4882a593Smuzhiyunand/or Yocto.
6*4882a593Smuzhiyun
7*4882a593SmuzhiyunThis layer depends on:
8*4882a593Smuzhiyun
9*4882a593Smuzhiyun* URI: git://git.openembedded.org/openembedded-core
10*4882a593Smuzhiyun  - branch: master
11*4882a593Smuzhiyun  - revision: HEAD
12*4882a593Smuzhiyun
13*4882a593Smuzhiyun* URI: git://git.openembedded.org/meta-openembedded
14*4882a593Smuzhiyun  - layers: meta-oe
15*4882a593Smuzhiyun  - branch: master
16*4882a593Smuzhiyun  - revision: HEAD
17*4882a593Smuzhiyun
18*4882a593Smuzhiyun* URI: git://github.com/kraj/meta-clang
19*4882a593Smuzhiyun  - branch: master
20*4882a593Smuzhiyun  - revision: HEAD
21*4882a593Smuzhiyun
22*4882a593Smuzhiyun* URI: git://github.com/meta-rust/meta-rust
23*4882a593Smuzhiyun  - branch: master
24*4882a593Smuzhiyun  - revision: HEAD
25*4882a593Smuzhiyun
26*4882a593Smuzhiyun* python2.7 and python on host for HOSTTOOLS
27*4882a593Smuzhiyun  - e.g. on newer ubuntu which doesn't install python2 at all by default
28*4882a593Smuzhiyun    you need to install python-is-python2 (which will pull python2-minimal/python2.7-minimal)
29*4882a593Smuzhiyun
30*4882a593SmuzhiyunContributing
31*4882a593Smuzhiyun------------
32*4882a593Smuzhiyun
33*4882a593SmuzhiyunThe preferred way to contribute to this layer is to send GitHub pull requests or
34*4882a593Smuzhiyunreport problems in GitHub's issue tracker.
35*4882a593Smuzhiyun
36*4882a593SmuzhiyunAlternatively there is the classic way of review on the OpenEmbedded dev mailing
37*4882a593Smuzhiyunlist openembedded-devel@lists.openembedded.org (you have to be subscribed to
38*4882a593Smuzhiyunpost to the list). Please cc the maintainers if you send your patches.
39*4882a593Smuzhiyun
40*4882a593SmuzhiyunMaintainers
41*4882a593Smuzhiyun-----------
42*4882a593Smuzhiyun* Fabio Berton <fabio.berton@ossystems.com.br>
43*4882a593Smuzhiyun* Khem Raj <raj.khem@gmail.com>
44*4882a593Smuzhiyun* Otavio Salvador <otavio@ossystems.com.br>
45*4882a593Smuzhiyun* Takuro Ashie <ashie@clear-code.com>
46*4882a593Smuzhiyun
47*4882a593SmuzhiyunWhen sending single patches, please use something like :
48*4882a593Smuzhiyun```
49*4882a593Smuzhiyungit send-email -1 -s --to openembedded-devel@lists.openembedded.org --subject-prefix='meta-browser][PATCH'
50*4882a593Smuzhiyun```
51*4882a593Smuzhiyun
52*4882a593SmuzhiyunRecipes
53*4882a593Smuzhiyun-------
54*4882a593Smuzhiyunrecipes-browser/firefox:
55*4882a593SmuzhiyunFirefox browser.
56*4882a593Smuzhiyun
57*4882a593SmuzhiyunThis recipe provides a package for the Firefox web browser.
58*4882a593Smuzhiyun
59*4882a593SmuzhiyunPACKAGECONFIG knobs
60*4882a593Smuzhiyun-------------------
61*4882a593Smuzhiyun* alsa: (detected automatically)
62*4882a593Smuzhiyun  Enable ALSA support to play audio. It will be enabled automatically when
63*4882a593Smuzhiyun  DISTRO_FEATURES contains "alsa". Note that Firefox's default audio backend
64*4882a593Smuzhiyun  is PulseAudio, not ALSA. Although it's not enabled in official build, we
65*4882a593Smuzhiyun  enable it by default to make easy to play audio without additional daemons.
66*4882a593Smuzhiyun  When PulseAudio is running, it will be used instead of using ALSA directly
67*4882a593Smuzhiyun  even if this config is specified.
68*4882a593Smuzhiyun
69*4882a593Smuzhiyun* wayland: (detected automatically)
70*4882a593Smuzhiyun  Enable wayland support. It will be enabled automatically when DISTRO_FEATURES
71*4882a593Smuzhiyun  contains "wayland".
72*4882a593Smuzhiyun
73*4882a593Smuzhiyun* gpu: (off by default)
74*4882a593Smuzhiyun  Enable GPU acceleration.
75*4882a593Smuzhiyun
76*4882a593Smuzhiyun* openmax: (off by default)
77*4882a593Smuzhiyun  Enable OpenMAX IL decoder to play H.264 video.
78*4882a593Smuzhiyun  This features is confirmed only on Renesas RZ/G1.
79*4882a593Smuzhiyun
80*4882a593Smuzhiyun* webgl: (off by default)
81*4882a593Smuzhiyun  Firefox on Linux doesn't enable WebGL against most GPUs by default. This
82*4882a593Smuzhiyun  option adds a config file to enable it focedly.
83*4882a593Smuzhiyun
84*4882a593Smuzhiyun* forbit-multiple-compositors: (off by default)
85*4882a593Smuzhiyun  This option allows to create only one GPU accelerated compositor, second and
86*4882a593Smuzhiyun  the following windows will use basic compositors. Multiple compositor may
87*4882a593Smuzhiyun  cause crash on platforms that doesn't support multiple EGL windows.
88*4882a593Smuzhiyun
89*4882a593SmuzhiyunRuntime options
90*4882a593Smuzhiyun---------------
91*4882a593Smuzhiyun* The enviromental variable `GDK_BACKEND=wayland` is needed to run Firefox with
92*4882a593Smuzhiyun  the wayland backend.
93