add android dummy stub for java matter controller application

examples/build_overrides/build.gni

@@ -15,4 +15,5 @@
 declare_args() {
   # Root directory for build files.
   build_root = "//third_party/connectedhomeip/build"
+  build_java_matter_controller = true
 }

examples/java-matter-controller/BUILD.gn

@@ -21,8 +21,8 @@ import("${chip_root}/build/chip/tools.gni")
 
 android_binary("java-matter-controller") {
   output_name = "java-matter-controller"
-
   deps = [
+    "${chip_root}/examples/java-matter-controller/stub_src",
     "${chip_root}/src/controller/java",
     "${chip_root}/src/setup_payload/java",
     "${chip_root}/third_party/java_deps:annotation",

examples/java-matter-controller/java/src/com/matter/controller/Main.java

@@ -17,8 +17,11 @@
  */
 package com.matter.controller;
 
+import chip.devicecontroller.ChipDeviceController;
+
 public class Main {
   public static void main(String[] args) {
+    ChipDeviceController controller = new ChipDeviceController(null);
     System.out.println("Hello Matter Controller!");
 
     for (String s : args) {

examples/java-matter-controller/stub_src/BUILD.gn

@@ -0,0 +1,36 @@
+# Copyright (c) 2020-2021 Project CHIP Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import("//build_overrides/build.gni")
+import("//build_overrides/chip.gni")
+import("${build_root}/config/android_abi.gni")
+import("${chip_root}/build/chip/java/rules.gni")
+
+android_library("stub_src") {
+  output_name = "Android.jar"
+
+  sources = [
+    "android/annotations/Nullable.java",
+    "android/bluetooth/BluetoothGatt.java",
+    "android/bluetooth/BluetoothGattCallback.java",
+    "android/bluetooth/BluetoothGattCharacteristic.java",
+    "android/bluetooth/BluetoothGattDescriptor.java",
+    "android/bluetooth/BluetoothGattService.java",
+    "android/bluetooth/BluetoothProfile.java",
+    "android/os/Build.java",
+    "android/util/Log.java",
+  ]
+
+  javac_flags = [ "-Xlint:deprecation" ]
+}

examples/java-matter-controller/stub_src/android/annotations/Nullable.java

@@ -0,0 +1,47 @@
+/*
+ * Copyright (C) 2010 The Android Open Source Project
+ *
+ * Licensed under the Eclipse Public License, Version 1.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.eclipse.org/org/documents/epl-v10.php
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Modified from AOSP
+
+package androidx.annotation;
+
+import static java.lang.annotation.ElementType.FIELD;
+import static java.lang.annotation.ElementType.LOCAL_VARIABLE;
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.ElementType.PARAMETER;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Denotes that a parameter, field or method return value can be null. <b>Note</b>: this is the
+ * default assumption for most Java APIs and the default assumption made by most static code
+ * checking tools, so usually you don't need to use this annotation; its primary use is to override
+ * a default wider annotation like {@link NonNullByDefault}.
+ *
+ * <p>When decorating a method call parameter, this denotes the parameter can legitimately be null
+ * and the method will gracefully deal with it. Typically used on optional parameters.
+ *
+ * <p>When decorating a method, this denotes the method might legitimately return null.
+ *
+ * <p>This is a marker annotation and it has no specific attributes.
+ */
+@Documented
+@Retention(RetentionPolicy.SOURCE)
+@Target({METHOD, PARAMETER, LOCAL_VARIABLE, FIELD})
+public @interface Nullable {}

examples/java-matter-controller/stub_src/android/bluetooth/BluetoothGatt.java

@@ -0,0 +1,53 @@
+/*
+ *
+ *    Copyright (c) 2023 Project CHIP Authors
+ *    Copyright (c) 2015-2017 Nest Labs, Inc.
+ *    All rights reserved.
+ *
+ *    Licensed under the Apache License, Version 2.0 (the "License");
+ *    you may not use this file except in compliance with the License.
+ *    You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+
+/** BluetoothGatt.java Stub file to allow compiling standalone, without Android SDK. */
+package android.bluetooth;
+
+import java.util.List;
+import java.util.UUID;
+
+// Stub class to allow standalone compilation without Android
+public final class BluetoothGatt {
+
+  public static final int GATT_SUCCESS = 0;
+
+  public void close() {}
+
+  public BluetoothGattService getService(UUID uuid) {
+    return null;
+  }
+
+  public List<BluetoothGattService> getServices() {
+    return null;
+  }
+
+  public boolean setCharacteristicNotification(
+      BluetoothGattCharacteristic characteristic, boolean enable) {
+    return false;
+  }
+
+  public boolean writeCharacteristic(BluetoothGattCharacteristic characteristic) {
+    return false;
+  }
+
+  public boolean writeDescriptor(BluetoothGattDescriptor descriptor) {
+    return false;
+  }
+}

examples/java-matter-controller/stub_src/android/bluetooth/BluetoothGattCallback.java

@@ -0,0 +1,43 @@
+/*
+ *
+ *    Copyright (c) 2023 Project CHIP Authors
+ *    Copyright (c) 2015-2017 Nest Labs, Inc.
+ *    All rights reserved.
+ *
+ *    Licensed under the Apache License, Version 2.0 (the "License");
+ *    you may not use this file except in compliance with the License.
+ *    You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+
+/** BluetoothGattCallback.java Stub file to allow compiling standalone, without Android SDK. */
+package android.bluetooth;
+
+// Stub class to allow standalone compilation without Android
+public abstract class BluetoothGattCallback {
+  public void onCharacteristicChanged(
+      BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) {}
+
+  public void onCharacteristicRead(
+      BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {}
+
+  public void onCharacteristicWrite(
+      BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {}
+
+  public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {}
+
+  public void onDescriptorRead(
+      BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status) {}
+
+  public void onDescriptorWrite(
+      BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status) {}
+
+  public void onServicesDiscovered(BluetoothGatt gatt, int status) {}
+}

examples/java-matter-controller/stub_src/android/bluetooth/BluetoothGattCharacteristic.java

@@ -0,0 +1,50 @@
+/*
+ *
+ *    Copyright (c) 2023 Project CHIP Authors
+ *    Copyright (c) 2015-2017 Nest Labs, Inc.
+ *    All rights reserved.
+ *
+ *    Licensed under the Apache License, Version 2.0 (the "License");
+ *    you may not use this file except in compliance with the License.
+ *    You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+
+/**
+ * BluetoothGattCharacteristic.java Stub file to allow compiling standalone, without Android SDK.
+ */
+package android.bluetooth;
+
+import java.util.UUID;
+
+// Stub class to allow standalone compilation without Android
+public class BluetoothGattCharacteristic {
+  protected UUID mUuid;
+
+  public BluetoothGattDescriptor getDescriptor(UUID uuid) {
+    return null;
+  }
+
+  public BluetoothGattService getService() {
+    return null;
+  }
+
+  public UUID getUuid() {
+    return mUuid;
+  }
+
+  public byte[] getValue() {
+    return null;
+  }
+
+  public boolean setValue(byte[] value) {
+    return false;
+  }
+}

examples/java-matter-controller/stub_src/android/bluetooth/BluetoothGattDescriptor.java

@@ -0,0 +1,50 @@
+/*
+ *
+ *    Copyright (c) 2023 Project CHIP Authors
+ *    Copyright (c) 2015-2017 Nest Labs, Inc.
+ *    All rights reserved.
+ *
+ *    Licensed under the Apache License, Version 2.0 (the "License");
+ *    you may not use this file except in compliance with the License.
+ *    You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+
+/** BluetoothGattDescriptor.java Stub file to allow compiling standalone, without Android SDK. */
+package android.bluetooth;
+
+import java.util.UUID;
+
+// Stub class to allow standalone compilation without Android
+public class BluetoothGattDescriptor {
+  public static final byte[] ENABLE_NOTIFICATION_VALUE = {0x01, 0x00};
+
+  public static final byte[] ENABLE_INDICATION_VALUE = {0x02, 0x00};
+
+  public static final byte[] DISABLE_NOTIFICATION_VALUE = {0x00, 0x00};
+
+  protected UUID mUuid;
+
+  public BluetoothGattCharacteristic getCharacteristic() {
+    return null;
+  }
+
+  public UUID getUuid() {
+    return mUuid;
+  }
+
+  public byte[] getValue() {
+    return null;
+  }
+
+  public boolean setValue(byte[] value) {
+    return true;
+  }
+}

examples/java-matter-controller/stub_src/android/bluetooth/BluetoothGattService.java

@@ -0,0 +1,41 @@
+/*
+ *
+ *    Copyright (c) 2023 Project CHIP Authors
+ *    Copyright (c) 2015-2017 Nest Labs, Inc.
+ *    All rights reserved.
+ *
+ *    Licensed under the Apache License, Version 2.0 (the "License");
+ *    you may not use this file except in compliance with the License.
+ *    You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+
+/** BluetoothGattService.java Stub file to allow compiling standalone, without Android SDK. */
+package android.bluetooth;
+
+import java.util.List;
+import java.util.UUID;
+
+// Stub class to allow standalone compilation without Android
+public class BluetoothGattService {
+  protected UUID mUuid;
+
+  public BluetoothGattCharacteristic getCharacteristic(UUID uuid) {
+    return null;
+  }
+
+  public List<BluetoothGattCharacteristic> getCharacteristics() {
+    return null;
+  }
+
+  public UUID getUuid() {
+    return mUuid;
+  }
+}

examples/java-matter-controller/stub_src/android/bluetooth/BluetoothProfile.java

@@ -0,0 +1,34 @@
+/*
+ *
+ *    Copyright (c) 2023 Project CHIP Authors
+ *    Copyright (c) 2015-2017 Nest Labs, Inc.
+ *    All rights reserved.
+ *
+ *    Licensed under the Apache License, Version 2.0 (the "License");
+ *    you may not use this file except in compliance with the License.
+ *    You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+
+/** BluetoothProfile.java Stub file to allow compiling standalone, without Android SDK. */
+package android.bluetooth;
+
+// Stub class to allow standalone compilation without Android
+public final class BluetoothProfile {
+
+  /** The profile is in disconnected state */
+  public static final int STATE_DISCONNECTED = 0;
+  /** The profile is in connecting state */
+  public static final int STATE_CONNECTING = 1;
+  /** The profile is in connected state */
+  public static final int STATE_CONNECTED = 2;
+  /** The profile is in disconnecting state */
+  public static final int STATE_DISCONNECTING = 3;
+}