Home | History | Annotate | Download | only in pm 
      1 /*
      2  * Copyright (C) 2015 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 package com.android.car.pm;
     17 
     18 import android.annotation.Nullable;
     19 import android.content.Context;
     20 import android.content.pm.ActivityInfo;
     21 import android.content.pm.PackageInfo;
     22 import android.content.pm.PackageManager;
     23 import android.content.pm.PackageManager.NameNotFoundException;
     24 import android.os.Bundle;
     25 import android.util.Log;
     26 
     27 import com.android.car.CarLog;
     28 
     29 import java.util.ArrayList;
     30 import java.util.List;
     31 
     32 /**
     33  *  Read App meta data and look for Distraction Optimization(DO) tags.
     34  *  An app can tag a distraction optimized activity to be DO by adding the following meta-data
     35  *  to that <activity> element:
     36  *
     37  *  <pre>{@code
     38  *  <activity>
     39  *      <meta-data android:name="distractionOptimized" android:value="true"/>
     40  *  </activity>
     41  *  }</pre>
     42  *
     43  */
     44 public class CarAppMetadataReader {
     45     /** Name of the meta-data attribute of the Activity that denotes distraction optimized */
     46     private static final String DO_METADATA_ATTRIBUTE = "distractionOptimized";
     47 
     48     /**
     49      * Parses the given package and returns Distraction Optimized information, if present.
     50      *
     51      * @return Array of DO activity names in the given package
     52      */
     53     @Nullable
     54     public static String[] findDistractionOptimizedActivities(Context context, String packageName)
     55             throws NameNotFoundException {
     56         final PackageManager pm = context.getPackageManager();
     57 
     58         // Check if any of the activities in the package are DO by checking all the
     59         // <activity> elements.
     60         PackageInfo pkgInfo =
     61                 pm.getPackageInfo(
     62                         packageName, PackageManager.GET_ACTIVITIES
     63                                 | PackageManager.GET_META_DATA
     64                                 | PackageManager.MATCH_DIRECT_BOOT_AWARE
     65                                 | PackageManager.MATCH_DIRECT_BOOT_UNAWARE);
     66         if (pkgInfo == null) {
     67             return null;
     68         }
     69 
     70         ActivityInfo[] activities = pkgInfo.activities;
     71         if (activities == null) {
     72             if (Log.isLoggable(CarLog.TAG_PACKAGE, Log.DEBUG)) {
     73                 Log.d(CarLog.TAG_PACKAGE, "Null Activities for " + packageName);
     74             }
     75             return null;
     76         }
     77         List<String> optimizedActivityList = new ArrayList();
     78         for (ActivityInfo activity : activities) {
     79             Bundle mData = activity.metaData;
     80             if (mData != null && mData.getBoolean(DO_METADATA_ATTRIBUTE, false)) {
     81                 if (Log.isLoggable(CarLog.TAG_PACKAGE, Log.DEBUG)) {
     82                     Log.d(CarLog.TAG_PACKAGE,
     83                             "DO Activity:" + activity.packageName + "/" + activity.name);
     84                 }
     85                 optimizedActivityList.add(activity.name);
     86             }
     87         }
     88         if (optimizedActivityList.isEmpty()) {
     89             return null;
     90         }
     91         return optimizedActivityList.toArray(new String[optimizedActivityList.size()]);
     92     }
     93 }
     94