xref: /aosp_15_r20/external/libvpx/README.android (revision fb1b10ab9aebc7c7068eedab379b749d7e3900be)
1*fb1b10abSAndroid Build Coastguard WorkerName: libvpx
2*fb1b10abSAndroid Build Coastguard WorkerURL: http://www.webmproject.org
3*fb1b10abSAndroid Build Coastguard WorkerVersion: v1.15.0
4*fb1b10abSAndroid Build Coastguard WorkerLicense: BSD
5*fb1b10abSAndroid Build Coastguard WorkerLicense File: libvpx/LICENSE
6*fb1b10abSAndroid Build Coastguard Worker
7*fb1b10abSAndroid Build Coastguard WorkerDate: Tuesday November 05 2024
8*fb1b10abSAndroid Build Coastguard WorkerBranch: v1.15.0
9*fb1b10abSAndroid Build Coastguard WorkerCommit: 9f9b7e9ba2eb9d01640a9e69a3d655866265cf7f
10*fb1b10abSAndroid Build Coastguard Worker
11*fb1b10abSAndroid Build Coastguard WorkerCherry-picks:
12*fb1b10abSAndroid Build Coastguard Worker24b568e6f libs.mk: Expose RC_RTC_SRCS as libvpxrc_srcs.txt
13*fb1b10abSAndroid Build Coastguard Worker
14*fb1b10abSAndroid Build Coastguard WorkerDescription:
15*fb1b10abSAndroid Build Coastguard WorkerContains the sources used to compile libvpx.
16*fb1b10abSAndroid Build Coastguard Worker
17*fb1b10abSAndroid Build Coastguard WorkerThe libvpx source is from webmproject.org:
18*fb1b10abSAndroid Build Coastguard Worker  https://chromium.googlesource.com/webm/libvpx
19*fb1b10abSAndroid Build Coastguard Worker
20*fb1b10abSAndroid Build Coastguard WorkerNotes on updating libvpx source code:
21*fb1b10abSAndroid Build Coastguard Worker
22*fb1b10abSAndroid Build Coastguard WorkerPlease follow these steps to update libvpx source code:
23*fb1b10abSAndroid Build Coastguard Worker
24*fb1b10abSAndroid Build Coastguard Worker1. Update libvpx source tree. Look for "Current HEAD: <hash>" output to update
25*fb1b10abSAndroid Build Coastguard Worker   README.android. Look for "git log from upstream: <git log>" output to add
26*fb1b10abSAndroid Build Coastguard Worker   to the commit message.
27*fb1b10abSAndroid Build Coastguard Worker
28*fb1b10abSAndroid Build Coastguard Worker   ./update_libvpx.sh [branch name]
29*fb1b10abSAndroid Build Coastguard Worker
30*fb1b10abSAndroid Build Coastguard Worker2. Generate updated .gypi and config files.
31*fb1b10abSAndroid Build Coastguard Worker
32*fb1b10abSAndroid Build Coastguard Worker   ./generate_config.sh
33*fb1b10abSAndroid Build Coastguard Worker
34*fb1b10abSAndroid Build Coastguard Worker3. Update this file with any Version, Date, Branch, or Commit changes. The
35*fb1b10abSAndroid Build Coastguard Worker   version is in the file source/config/vpx_version.h
36*fb1b10abSAndroid Build Coastguard Worker
37*fb1b10abSAndroid Build Coastguard Worker4. Commit the changes. The commit message should look like this and is printed
38*fb1b10abSAndroid Build Coastguard Worker   by update_libvpx.sh:
39*fb1b10abSAndroid Build Coastguard Worker   libvpx: Pull from upstream
40*fb1b10abSAndroid Build Coastguard Worker
41*fb1b10abSAndroid Build Coastguard Worker   Current HEAD: <hash>
42*fb1b10abSAndroid Build Coastguard Worker
43*fb1b10abSAndroid Build Coastguard Worker   git log from upstream:
44*fb1b10abSAndroid Build Coastguard Worker   a6b2070 <git commit message 1>
45*fb1b10abSAndroid Build Coastguard Worker   08dabbc <git commit message 2>
46*fb1b10abSAndroid Build Coastguard Worker   c29fb02 <git commit message 3>
47*fb1b10abSAndroid Build Coastguard Worker
48*fb1b10abSAndroid Build Coastguard WorkerTools needed to build libvpx:
49*fb1b10abSAndroid Build Coastguard Worker
50*fb1b10abSAndroid Build Coastguard Worker- generate_config.sh
51*fb1b10abSAndroid Build Coastguard Worker
52*fb1b10abSAndroid Build Coastguard WorkerGenerate config files that contain the source list for each platform.
53*fb1b10abSAndroid Build Coastguard WorkerConfiguration for the build is taken from vpx_config.h for each platform.
54*fb1b10abSAndroid Build Coastguard Worker
55*fb1b10abSAndroid Build Coastguard Worker- lint_config.sh
56*fb1b10abSAndroid Build Coastguard Worker
57*fb1b10abSAndroid Build Coastguard WorkerA tool to verify vpx_config.h and vpx_config.asm are matched. This also
58*fb1b10abSAndroid Build Coastguard Workerprints the final configuration after checking.
59*fb1b10abSAndroid Build Coastguard Worker
60