summaryrefslogtreecommitdiffstats
path: root/p2gen/README.txt
diff options
context:
space:
mode:
authorGreg Hartman <ghartman@google.com>2018-08-17 12:43:34 -0700
committerGreg Hartman <ghartman@google.com>2018-08-23 17:24:52 -0700
commit8cf8f6b088cc014921e1a9b3d4ebc93c3b5de8b8 (patch)
treed4968732d8516f2940cfcb340bacdf7693e0ceb3 /p2gen/README.txt
parent182e4691d1c5e724fc60ed94b6de8a3356018cb6 (diff)
downloaddevice_generic_opengl-transport-8cf8f6b088cc014921e1a9b3d4ebc93c3b5de8b8.tar.gz
device_generic_opengl-transport-8cf8f6b088cc014921e1a9b3d4ebc93c3b5de8b8.tar.bz2
device_generic_opengl-transport-8cf8f6b088cc014921e1a9b3d4ebc93c3b5de8b8.zip
distrib/android-emugl: Move Android GPU emulation sources here.
This patch is used to add the unmodified sources of the GPU emulation libraries that are normally under sdk/emulator/opengl/. These sources were originally built with the platform build system, but this is no longer the case. Since they are only built through the emulator's own build system (i.e. android-rebuild.sh), it's easier to put them under external/qemu/ to ensure that they are always in sync with the rest of the emulator. Note that the encoder sources are still in the platform under device/generic/goldfish/opengl/. A future patch will update the emulator build system to pick the sources from here, and another one will remove the sources from sdk/ after that. Note: these are the unmodified sources from the following commit in https://android.googlesource.com/platform/sdk.git : 182e469 emulator/opengl: Fix Windows cross-build. Change-Id: If2010577ef4af4c6755ab345f424af0b546f9282
Diffstat (limited to 'p2gen/README.txt')
-rw-r--r--p2gen/README.txt73
1 files changed, 0 insertions, 73 deletions
diff --git a/p2gen/README.txt b/p2gen/README.txt
deleted file mode 100644
index 3443b03f2..000000000
--- a/p2gen/README.txt
+++ /dev/null
@@ -1,73 +0,0 @@
-Summary:
-
-To generate p2 artifacts from jars, run:
-$ mvn --no-snapshot-updates --offline p2:site \
- -Dmaven.repo.local=../../out/host/maven/localrepo
-The folder ${build.directory}/repository contains the resultant
-p2 repository. ${build.directory} is defined inside pom.xml
-
-Details:
-
-The Eclipse plugins in $root/sdk/eclipse/plugins depend on a number
-of jar files from:
- $root/tools/base
- $root/tools/swt
- $root/prebuilts/tools/common/m2/repository
-
-In earlier versions, a script (create_all_symlinks.sh) knew about
-which plugins depended on which jars, and when executed, it would
-copy over those jars into the plugin's libs folder. Each plugin
-included the jars from its libs folder as part of its classpath,
-and the entire libs folder was bundled inside the plugin.
-
-Such a scheme has a number of issues:
- - bundling jars inside libs/ folder inside each plugin is not
- recommended by Eclipse. This causes performance degradation
- at runtime.
- - at build time, the script modifies the source folders to add
- the contents inside libs folder. Ideally, the source folders
- shouldn't be modified during build.
- - the script has to maintain state about which plugin depends
- on which jars.
-
-The approach suggested by Eclipse is to replace the regular jars
-with OSGI bundles, and for each plugin to explicitly add a dependency
-to the required OSGI bundles. In essence, this makes each of the
-jars to be similar to a plugin.
-
-This folder contains scripts that can be used to convert a set
-of jars into OSGI bundles using the p2-maven-plugin
-(https://github.com/reficio/p2-maven-plugin).
-
-$ mvn --no-snapshot-updates \
- --offline \
- -Dmaven.repo.local=../../out/host/maven/localRepo \
- p2:site
-
-The pom.xml file lists the set of jars to be processed. The
-runtime options to Maven include:
- --offline: We don't want Maven to fetch anything from the internet.
- All required dependencies must be checked into git.
- --no-snapshot-updates: If the tools artifacts have a -SNAPSHOT
- in them, Maven will attempt to re-download those artifacts,
- which would fail since we are running in offline mode. This
- option instructs Maven to not attempt to download these
- snapshots and use whatever is available in the local repositories.
- -Dmaven.repo.local=path to the local repository that should be
- used by maven. Without this, it'll use $HOME/.m2. This should
- be initialized with all the necessary artifacts if running in
- offline mode.
-
-Additional considerations for running in offline mode:
-
-When running in online mode, there are 3 sources from which files
-are downloaded by Maven:
- 1 Maven Central
- 2 the repository where the tools/base and tools/swt artifacts are
- generated
- 3 the prebuilts/tools/common/m2 repository (this is a subset of 1).
-Even though 2 and 3 are available locally, we cannot just use them
-in offline mode since Maven treats repositories with file:/// urls
-as remote as well. As a result, the only way to run offline is to
-first explicitly copy the contents of 2 and 3 into the local repository
-(-Dmaven.repo.local) before initiating an offline build.