summaryrefslogtreecommitdiff
path: root/main/src/com/google/android/setupdesign/util/DeviceHelper.java
blob: 740e3b371cd107ae0a7da1e511d544d783833b28 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
/*
 * Copyright (C) 2022 The Android Open Source Project
 *
 * 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.
 */

package com.google.android.setupdesign.util;

import android.annotation.SuppressLint;
import android.content.ContentResolver;
import android.content.Context;
import android.content.res.Resources.NotFoundException;
import android.net.Uri;
import android.os.Bundle;
import android.text.TextUtils;
import android.util.Log;
import androidx.annotation.NonNull;
import androidx.annotation.VisibleForTesting;
import com.google.android.setupcompat.util.Logger;

/** Helper class to get attributes of the device, like a friendly display name. */
public final class DeviceHelper {

  private static final Logger LOG = new Logger("DeviceHelper");
  private static final String TAG = DeviceHelper.class.getSimpleName();

  @VisibleForTesting
  public static final String SUW_AUTHORITY = "com.google.android.setupwizard.partner";

  @VisibleForTesting public static final String DEVICE_NAME = "device_name";
  private static final String STRING = "string";
  @VisibleForTesting public static final String GET_DEVICE_NAME_METHOD = "getDeviceName";

  @VisibleForTesting public static Bundle deviceName = null;

  /**
   * Get the device name text from these resources, if they are unavailable or setupwizard apk is
   * older which does not contains {@link DeviceHelper#GET_DEVICE_NAME_METHOD} method, return the
   * device name as default value "device".
   *
   * <p>Priority: partner config ({@link
   * com.google.android.setupwizard.util.PartnerResource#DEVICE_NAME}) > {@link
   * android.provider.Settings.Global#DEVICE_NAME} > system property ro.product.model)
   */
  public static CharSequence getDeviceName(@NonNull Context context) {
    return getDeviceName(context, /* enableCache= */ true);
  }

  /**
   * Get the device name text from these resources, if they are unavailable or setupwizard apk is
   * older which does not contains {@link DeviceHelper#GET_DEVICE_NAME_METHOD} method, return the
   * device name as default value "device".
   *
   * <p>Priority: partner config ({@link
   * com.google.android.setupwizard.util.PartnerResource#DEVICE_NAME}) > {@link
   * android.provider.Settings.Global#DEVICE_NAME} > system property ro.product.model)
   *
   * @param enableCache Indicates whether the device name is preferentially obtained from the cache.
   */
  @NonNull
  @SuppressLint("DiscouragedApi")
  public static CharSequence getDeviceName(@NonNull Context context, boolean enableCache) {
    if (deviceName == null || deviceName.isEmpty() || !enableCache) {
      try {
        deviceName =
            context
                .getContentResolver()
                .call(
                    new Uri.Builder()
                        .scheme(ContentResolver.SCHEME_CONTENT)
                        .authority(SUW_AUTHORITY)
                        .build(),
                    GET_DEVICE_NAME_METHOD,
                    /* arg= */ null,
                    /* extras= */ null);
      } catch (IllegalArgumentException | SecurityException exception) {
        Log.w(TAG, "device name unknown; return the device name as default value");
      }
    }

    if (deviceName != null && !deviceName.isEmpty()) {
      return deviceName.getCharSequence(GET_DEVICE_NAME_METHOD, null);
    }

    Partner partner = Partner.get(context);
    if (partner != null) {
      try {
        int resId =
            partner.getResources().getIdentifier(DEVICE_NAME, STRING, partner.getPackageName());
        String overlayDeviceName = partner.getResources().getString(resId);
        if (!TextUtils.isEmpty(overlayDeviceName)) {
          return overlayDeviceName;
        } else {
          LOG.w("The overlayDeviceName is null!");
        }
      } catch (NotFoundException ex) {
        // fall through
      }
    }

    return context.getString(
        com.google.android.setupdesign.strings.R.string.sud_default_device_name);
  }

  private DeviceHelper() {}
}