Import ConstraintLayout 2.0.1 to github

Import ConstraintLayout 2.0.1 sources

Author: camaelon

constraintlayout/README

@@ -0,0 +1,23 @@
+Building the ConstraintLayout library
+=====================================
+
+Several environment variables need to be set:
+  
+  export ANDROID_HOME=~/Android/Sdk/
+  export ANDROID_M2REPOSITORY=$ANDROID_HOME/extras/android/m2repository
+
+  mkdir -p /tmp/out/dist
+  OUT_DIR=/tmp/out
+  DIST_DIR=/tmp/out/dist
+
+  export STUDIO_MASTER=~/studio-master-dev/
+  export CL_PREBUILTS=$STUDIO_MASTER/prebuilts/tools/common/offline-m2/
+  export DOCLAVA_PREBUILTS=$STUDIO_MASTER/external/
+  export DOCLAVA_ROOTDIR=$STUDIO_MASTER/tools/sherpa/
+
+To compile and publish to your local offline M2 repository, you need to run:
+  ./buildLocally.sh
+
+To generate the maven artifact, you then need to run:
+
+  ./gradlew dist

constraintlayout/build.gradle

@@ -0,0 +1,157 @@
+buildscript {
+    repositories {
+        // maven { url "$project.rootDir/../../prebuilts/tools/common/offline-m2" }
+        //maven { url System.env.CL_PREBUILTS }
+	google()
+	jcenter()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:3.1.0'
+
+        // NOTE: Do not place your application dependencies here; they belong
+        // in the individual module build.gradle files
+    }
+}
+
+import com.google.common.io.Files
+import com.google.common.base.Charsets
+
+task('checkJavaVersion') doLast {
+    def jvmVersion = System.getProperty('java.version')
+    def requiredVersion = System.getenv('JAVA_FOR_TESTS') ?: '1.8'
+    if (!jvmVersion.startsWith(requiredVersion)) {
+        throw new RuntimeException("Tools need to be compiled with Java $requiredVersion, you are using Java $jvmVersion.")
+    }
+}
+final def checkJavaVersionTask = tasks['checkJavaVersion']
+
+ext.version = '2.0.1'
+
+/*
+ * With the build server you are given two env variables.
+ * The OUT_DIR is a temporary directory you can use to put things during the build.
+ * The DIST_DIR is where you want to save things from the build.
+ *
+ * The build server will copy the contents of DIST_DIR to somewhere and make it available.
+ */
+if (System.env.DIST_DIR != null && System.env.OUT_DIR != null) {
+    ext.androidHostOut = file(System.env.OUT_DIR)
+    ext.androidHostDist = file(System.env.DIST_DIR)
+    ext.buildNumber = System.env.BUILD
+} else {
+    // ext.androidHostOut is shared by all tools/{base,build,swt} gradle projects/
+    ext.androidHostOut = file("$rootDir/../../out")
+    ext.androidHostDist = new File(ext.androidHostOut, "dist")
+    ext.buildNumber = null
+}
+
+// rootProject.buildDir is specific to this gradle build.
+buildDir = new File(ext.androidHostOut, "build/root")
+ext.supportRepoOut = new File(buildDir, 'repo')
+
+ext.localRepo = project.hasProperty('localRepo') ? localRepo : "$ext.androidHostOut/repo"
+
+// basic task for custom distribution of project via the build server.
+task dist doLast {
+}
+
+project(':constraintlayout') {
+    ext.pomName = 'Android ConstraintLayout'
+    ext.pomDesc = 'ConstraintLayout for Android'
+}
+
+project(':solver') {
+    ext.pomName = 'Android ConstraintLayout Solver'
+    ext.pomDesc = 'Solver for ConstraintLayout'
+}
+
+subprojects { Project project ->
+    // Change buildDir first so that all plugins pick up the new value.
+    project.buildDir = project.file("$project.parent.buildDir/../$project.name/build")
+
+    group = 'androidx.constraintlayout'
+    version = rootProject.ext.version
+
+    apply plugin: 'maven'
+
+    repositories {
+        maven { url "$rootProject.projectDir/../../prebuilts/tools/common/m2/repository" }
+    }
+
+    task release(type: Upload) {
+        configuration = configurations.archives
+        repositories {
+            mavenDeployer {
+                repository(url: uri("$rootProject.ext.supportRepoOut"))
+		if (project.getName() == 'constraintlayout' || project.getName() == 'solver') {
+		    pom.project {
+		        name project.ext.pomName
+		        description project.ext.pomDesc
+
+		        url 'http://tools.android.com'
+			inceptionYear '2007'
+
+			licenses {
+			    license {
+			        name 'The Apache Software License, Version 2.0'
+				url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
+				distribution 'repo'
+		            }
+		        }
+
+			scm {
+			    url 'https://android.googlesource.com/platform/tools/sherpa'
+			    connection 'git://android.googlesource.com/platform/tools/sherpa.git'
+		        }
+			developers {
+		   	    developer {
+				name 'The Android Open Source Project'
+			    }
+			}
+		    }
+		}
+            }
+        }
+    }
+
+    def versionDir = {
+        def groupDir = new File(rootProject.ext.supportRepoOut, project.group.replace('.','/'))
+        def artifactDir = new File(groupDir, archivesBaseName)
+        return new File(artifactDir, version)
+    }
+
+    def deployer = release.repositories.mavenDeployer
+    task generateSourceProps(dependsOn: release) doLast {
+        def content = "Maven.GroupId=$deployer.pom.groupId\n" +
+            "Maven.ArtifactId=$deployer.pom.artifactId\n" +
+            "Maven.Version=$deployer.pom.version\n" +
+            "Pkg.Desc=$project.ext.pomDesc $deployer.pom.version\n" +
+            "Pkg.Revision=1\n" +
+            "Extra.VendorId=android\n" +
+            "Extra.VendorDisplay=Android\n" +
+            "Maven.Dependencies=" +
+            String.join(",", project.configurations.implementation.allDependencies.collect {
+                    def p = parent.findProject(it.name)
+                    return p ? "$p.group:$p.archivesBaseName:$p.version" : null
+                }.grep()) +
+            "\n"
+        Files.write(content, new File(versionDir(), 'source.properties'), Charsets.UTF_8)
+    }
+
+    task createSeparateZip(type: Zip, dependsOn: generateSourceProps)  {
+        into archivesBaseName
+        destinationDir project.parent.ext.androidHostDist
+        baseName = project.group
+        version = rootProject.ext.buildNumber
+	archiveName = archivesBaseName + "-" + project.parent.ext.version + ".zip"
+    }
+    project.parent.dist.dependsOn createSeparateZip
+    createSeparateZip.dependsOn release
+
+    project.afterEvaluate {
+        // The archivesBaseName isn't available intially, so set it now
+        def createZipTask = project.tasks.getByName("createSeparateZip")
+        createZipTask.appendix = archivesBaseName
+        createZipTask.from versionDir()
+    }
+}

constraintlayout/constraintlayout/build.gradle

@@ -0,0 +1,116 @@
+apply plugin: 'com.android.library'
+apply plugin: 'maven'
+
+def latestSdkVersion = 28
+
+android {
+    compileSdkVersion latestSdkVersion
+    buildToolsVersion "28"
+
+    defaultConfig {
+        minSdkVersion 14
+        targetSdkVersion latestSdkVersion
+    }
+
+    lintOptions {
+        abortOnError false
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+
+    // TODO replace with https://issuetracker.google.com/issues/72050365 once released.
+    libraryVariants.all {
+        it.generateBuildConfig.enabled = false
+    }
+}
+
+repositories {
+    google()
+    jcenter()
+}
+
+configurations {
+    //doclava
+}
+
+dependencies {
+    implementation 'androidx.appcompat:appcompat:1.2.0'
+    implementation 'androidx.core:core:1.3.1'
+    implementation project(':solver')
+    // doclava project(':doclava')
+}
+
+archivesBaseName = 'constraintlayout'
+
+project.ext.pomName = 'Android ConstraintLayout'
+project.ext.pomDesc = 'ConstraintLayout for Android'
+
+task publishLocal(type: Upload) {
+    configuration = configurations.archives
+    repositories {
+        mavenDeployer {
+            repository(url: uri("$rootProject.ext.localRepo"))
+            pom.project {
+                name project.ext.pomName
+                description project.ext.pomDesc
+
+                url 'http://tools.android.com'
+                inceptionYear '2007'
+
+                licenses {
+                    license {
+                        name 'The Apache Software License, Version 2.0'
+                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
+                        distribution 'repo'
+                    }
+                }
+
+                scm {
+                    url 'https://android.googlesource.com/platform/tools/sherpa'
+                    connection 'git://android.googlesource.com/platform/tools/sherpa.git'
+                }
+                developers {
+                    developer {
+                        name 'The Android Open Source Project'
+                    }
+                }
+            }
+        }
+    }
+}
+
+// Call upon the DocLava tool to generate API reference
+/*
+task makeJavadocs(type: Javadoc, dependsOn: project.configurations.doclava) {
+    def docDir = "javadoc-offline"
+    if (project.hasProperty("online")) {
+        docDir = "javadoc-online"
+        options.addStringOption("dac_libraryroot", "android/support/constraint")
+        options.addStringOption("dac_dataname", "CONSTRAINT_DATA")
+        options.addStringOption("toroot", "/")
+        options.addStringOption("hdf", "dac")
+        options.addBooleanOption("devsite", true)
+        options.addBooleanOption("yamlV2", true)
+    }
+
+    title = null
+    destinationDir = new File(buildDir, docDir)
+    source = 'src/main/java'
+    def docRootDir = "$System.env.DOCLAVA_ROOTDIR"
+    classpath = files("${docRootDir}/../../prebuilts/sdk/${latestSdkVersion}/public/android.jar")
+    options.addStringOption "resourcesdir", "${docRootDir}/constraintlayout/resources/"
+    options.addStringOption "resourcesoutdir", "reference/android/support/constraint/resources/"
+    options.addStringOption "federate Android", "http://developer.android.com"
+    options.addStringOption "federationapi Android",
+                "${docRootDir}/../../prebuilts/sdk/${latestSdkVersion}/public/api/android.txt"
+    options.encoding = "UTF-8"
+    options.doclet = "com.google.doclava.Doclava"
+    options.docletpath = configurations.doclava.files.asType(List)
+    options.addStringOption("templatedir", "${docRootDir}/../../external/doclava/res/assets/templates-sdk/")
+    exclude '**/
+//BuildConfig.java'
+//    exclude '**/R.java'
+//}

constraintlayout/constraintlayout/resources/examples/ExampleConstraintSet.java

@@ -0,0 +1,37 @@
+package com.example.android.constraintapi;
+
+//BEGIN_INCLUDE(Example)
+import android.content.Context;
+import android.os.Bundle;
+import android.support.constraint.ConstraintLayout;
+import android.support.constraint.ConstraintSet;
+import android.support.transition.TransitionManager;
+import android.support.v7.app.AppCompatActivity;
+import android.view.View;
+
+public class MainActivity extends AppCompatActivity {
+    ConstraintSet mConstraintSet1 = new ConstraintSet(); // create a Constraint Set
+    ConstraintSet mConstraintSet2 = new ConstraintSet(); // create a Constraint Set
+    ConstraintLayout mConstraintLayout; // cache the ConstraintLayout
+    boolean mOld = true;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        Context context = this;
+        mConstraintSet2.clone(context, R.layout.state2); // get constraints from layout
+        setContentView(R.layout.state1);
+        mConstraintLayout = (ConstraintLayout) findViewById(R.id.activity_main);
+        mConstraintSet1.clone(mConstraintLayout); // get constraints from ConstraintSet
+    }
+
+    public void foo(View view) {
+        TransitionManager.beginDelayedTransition(mConstraintLayout);
+        if (mOld = !mOld) {
+            mConstraintSet1.applyTo(mConstraintLayout); // set new constraints
+        }  else {
+            mConstraintSet2.applyTo(mConstraintLayout); // set new constraints
+        }
+    }
+}
+//END_INCLUDE(Example)

constraintlayout/constraintlayout/resources/examples/Guideline.xml

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- BEGIN_INCLUDE(Guideline) -->
+<androidx.constraintlayout.widget.ConstraintLayout
+        xmlns:android="http://schemas.android.com/apk/res/android"
+        xmlns:app="http://schemas.android.com/apk/res-auto"
+        xmlns:tools="http://schemas.android.com/tools"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent">
+
+    <androidx.constraintlayout.widget.Guideline
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:id="@+id/guideline"
+            app:layout_constraintGuide_begin="100dp"
+            android:orientation="vertical"/>
+
+    <Button
+            android:text="Button"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:id="@+id/button"
+            app:layout_constraintLeft_toLeftOf="@+id/guideline"
+            android:layout_marginTop="16dp"
+            app:layout_constraintTop_toTopOf="parent" />
+
+</androidx.constraintlayout.widget.ConstraintLayout>
+<!-- END_INCLUDE(Guideline) -->

constraintlayout/constraintlayout/resources/images/barrier-adapt.png

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="androidx.constraintlayout.widget">
+
+    <application />
+</manifest>