pair of sample apps for using RemoteViews as a plugin mechanism

RemoteViews/Host/.classpath

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry kind="src" path="src"/>
+	<classpathentry kind="src" path="gen"/>
+	<classpathentry kind="con" path="com.android.ide.eclipse.adt.ANDROID_FRAMEWORK"/>
+	<classpathentry kind="con" path="com.android.ide.eclipse.adt.LIBRARIES"/>
+	<classpathentry kind="output" path="bin/classes"/>
+</classpath>

RemoteViews/Host/.project

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>RemoteViewsHost</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>com.android.ide.eclipse.adt.ResourceManagerBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.android.ide.eclipse.adt.PreCompilerBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.android.ide.eclipse.adt.ApkBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>com.android.ide.eclipse.adt.AndroidNature</nature>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+	</natures>
+</projectDescription>

RemoteViews/Host/AndroidManifest.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+	package="com.commonsware.android.rv.host"
+	android:versionCode="1"
+	android:versionName="1.0">
+
+	<uses-sdk
+		android:minSdkVersion="7"
+		android:targetSdkVersion="14"/>
+
+	<permission
+		android:name="com.commonsware.android.rv.host.ACT_AS_HOST"
+		android:description="@string/host_desc"
+		android:label="@string/host_label">
+	</permission>
+	<permission
+		android:name="com.commonsware.android.rv.host.ACT_AS_PLUGIN"
+		android:description="@string/plugin_desc"
+		android:label="@string/plugin_label">
+	</permission>
+
+	<uses-permission android:name="com.commonsware.android.rv.host.ACT_AS_HOST"/>
+	<supports-screens android:largeScreens="true" android:normalScreens="true" android:smallScreens="true"/>
+
+	<application
+		android:icon="@drawable/ic_launcher"
+		android:label="@string/app_name">
+		<activity
+			android:name=".RemoteViewsHostActivity"
+			android:label="@string/app_name">
+			<intent-filter>
+				<action android:name="android.intent.action.MAIN"/>
+
+				<category android:name="android.intent.category.LAUNCHER"/>
+			</intent-filter>
+		</activity>
+	</application>
+
+</manifest>

RemoteViews/Host/build.xml

@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project name="RemoteViewsHostActivity" default="help">
+
+    <!-- The local.properties file is created and updated by the 'android' tool.
+         It contains the path to the SDK. It should *NOT* be checked into
+         Version Control Systems. -->
+    <property file="local.properties" />
+
+    <!-- The ant.properties file can be created by you. It is only edited by the
+         'android' tool to add properties to it.
+         This is the place to change some Ant specific build properties.
+         Here are some properties you may want to change/update:
+
+         source.dir
+             The name of the source directory. Default is 'src'.
+         out.dir
+             The name of the output directory. Default is 'bin'.
+
+         For other overridable properties, look at the beginning of the rules
+         files in the SDK, at tools/ant/build.xml
+
+         Properties related to the SDK location or the project target should
+         be updated using the 'android' tool with the 'update' action.
+
+         This file is an integral part of the build system for your
+         application and should be checked into Version Control Systems.
+
+         -->
+    <property file="ant.properties" />
+
+    <!-- The project.properties file is created and updated by the 'android'
+         tool, as well as ADT.
+
+         This contains project specific properties such as project target, and library
+         dependencies. Lower level build properties are stored in ant.properties
+         (or in .classpath for Eclipse projects).
+
+         This file is an integral part of the build system for your
+         application and should be checked into Version Control Systems. -->
+    <loadproperties srcFile="project.properties" />
+
+    <!-- quick check on sdk.dir -->
+    <fail
+            message="sdk.dir is missing. Make sure to generate local.properties using 'android update project' or to inject it through an env var"
+            unless="sdk.dir"
+    />
+
+
+<!-- extension targets. Uncomment the ones where you want to do custom work
+     in between standard targets -->
+<!--
+    <target name="-pre-build">
+    </target>
+    <target name="-pre-compile">
+    </target>
+
+    /* This is typically used for code obfuscation.
+       Compiled code location: ${out.classes.absolute.dir}
+       If this is not done in place, override ${out.dex.input.absolute.dir} */
+    <target name="-post-compile">
+    </target>
+-->
+
+    <!-- Import the actual build file.
+
+         To customize existing targets, there are two options:
+         - Customize only one target:
+             - copy/paste the target into this file, *before* the
+               <import> task.
+             - customize it to your needs.
+         - Customize the whole content of build.xml
+             - copy/paste the content of the rules files (minus the top node)
+               into this file, replacing the <import> task.
+             - customize to your needs.
+
+         ***********************
+         ****** IMPORTANT ******
+         ***********************
+         In all cases you must update the value of version-tag below to read 'custom' instead of an integer,
+         in order to avoid having your file be overridden by tools such as "android update project"
+    -->
+    <!-- version-tag: 1 -->
+    <import file="${sdk.dir}/tools/ant/build.xml" />
+
+</project>

RemoteViews/Host/proguard.cfg

@@ -0,0 +1,40 @@
+-optimizationpasses 5
+-dontusemixedcaseclassnames
+-dontskipnonpubliclibraryclasses
+-dontpreverify
+-verbose
+-optimizations !code/simplification/arithmetic,!field/*,!class/merging/*
+
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Application
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+-keep public class * extends android.app.backup.BackupAgentHelper
+-keep public class * extends android.preference.Preference
+-keep public class com.android.vending.licensing.ILicensingService
+
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+-keepclasseswithmembers class * {
+    public <init>(android.content.Context, android.util.AttributeSet);
+}
+
+-keepclasseswithmembers class * {
+    public <init>(android.content.Context, android.util.AttributeSet, int);
+}
+
+-keepclassmembers class * extends android.app.Activity {
+   public void *(android.view.View);
+}
+
+-keepclassmembers enum * {
+    public static **[] values();
+    public static ** valueOf(java.lang.String);
+}
+
+-keep class * implements android.os.Parcelable {
+  public static final android.os.Parcelable$Creator *;
+}

RemoteViews/Host/project.properties

@@ -0,0 +1,11 @@
+# This file is automatically generated by Android Tools.
+# Do not modify this file -- YOUR CHANGES WILL BE ERASED!
+#
+# This file must be checked in Version Control Systems.
+#
+# To customize properties used by the Ant build system use,
+# "ant.properties", and override values to adapt the script to your
+# project structure.
+
+# Project target.
+target=android-7

RemoteViews/Host/res/layout/main.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<TextView xmlns:android="http://schemas.android.com/apk/res/android"
+	android:layout_width="fill_parent"
+	android:layout_height="wrap_content"
+	android:text="@string/hello"
+	android:textSize="20sp"/>

RemoteViews/Host/res/menu/options.xml

@@ -0,0 +1,8 @@
+<menu xmlns:android="http://schemas.android.com/apk/res/android">
+
+	<item
+		android:id="@+id/refresh"
+		android:icon="@android:drawable/ic_menu_rotate" android:title="@string/refresh">
+	</item>
+
+</menu>

RemoteViews/Host/res/values/strings.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+	<string name="hello">Choose Refresh from the options menu!</string>
+	<string name="app_name">RemoteViews Host</string>
+	<string name="host_label">Act as Plugin Host</string>
+	<string name="host_desc">Can serve as a host for plugins for the sample app</string>
+	<string name="plugin_label">Acts as Plugin</string>
+	<string name="plugin_desc">Serves as a plugin for the sample app\'s host</string>
+	<string name="refresh">Refresh</string>
+
+</resources>

RemoteViews/Host/src/com/commonsware/android/rv/host/RemoteViewsHostActivity.java

@@ -0,0 +1,117 @@
+/***
+  Copyright (c) 2012 CommonsWare, LLC
+  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.
+  
+  From _The Busy Coder's Guide to Advanced Android Development_
+    http://commonsware.com/AdvAndroid
+ */
+
+package com.commonsware.android.rv.host;
+
+import android.app.Activity;
+import android.content.BroadcastReceiver;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.os.Bundle;
+import android.view.Menu;
+import android.view.MenuInflater;
+import android.view.MenuItem;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.RemoteViews;
+
+public class RemoteViewsHostActivity extends Activity {
+  public static final String ACTION_CALL_FOR_PLUGINS=
+      "com.commonsware.android.rv.host.CALL_FOR_PLUGINS";
+  public static final String ACTION_REGISTER_PLUGIN=
+      "com.commonsware.android.rv.host.REGISTER_PLUGIN";
+  public static final String ACTION_CALL_FOR_CONTENT=
+      "com.commonsware.android.rv.host.CALL_FOR_CONTENT";
+  public static final String ACTION_DELIVER_CONTENT=
+      "com.commonsware.android.rv.host.DELIVER_CONTENT";
+  public static final String EXTRA_COMPONENT="component";
+  public static final String EXTRA_CONTENT="content";
+  public static final String PERM_ACT_AS_PLUGIN=
+      "com.commonsware.android.rv.host.ACT_AS_PLUGIN";
+  private ComponentName pluginCN=null;
+
+  @Override
+  public void onCreate(Bundle savedInstanceState) {
+    super.onCreate(savedInstanceState);
+    setContentView(R.layout.main);
+  }
+
+  @Override
+  public void onResume() {
+    super.onResume();
+
+    IntentFilter pluginFilter=new IntentFilter();
+
+    pluginFilter.addAction(ACTION_REGISTER_PLUGIN);
+    pluginFilter.addAction(ACTION_DELIVER_CONTENT);
+
+    registerReceiver(plugin, pluginFilter, PERM_ACT_AS_PLUGIN, null);
+
+    if (pluginCN == null) {
+      sendBroadcast(new Intent(ACTION_CALL_FOR_PLUGINS));
+    }
+  }
+
+  @Override
+  public void onPause() {
+    unregisterReceiver(plugin);
+
+    super.onPause();
+  }
+
+  @Override
+  public boolean onCreateOptionsMenu(Menu menu) {
+    new MenuInflater(this).inflate(R.menu.options, menu);
+
+    return(super.onCreateOptionsMenu(menu));
+  }
+
+  @Override
+  public boolean onOptionsItemSelected(MenuItem item) {
+    if (R.id.refresh == item.getItemId()) {
+      refreshPlugin();
+      return(true);
+    }
+
+    return(super.onOptionsItemSelected(item));
+  }
+
+  private void refreshPlugin() {
+    Intent call=new Intent(ACTION_CALL_FOR_CONTENT);
+
+    call.setComponent(pluginCN);
+    sendBroadcast(call);
+  }
+
+  private BroadcastReceiver plugin=new BroadcastReceiver() {
+    @Override
+    public void onReceive(Context ctxt, Intent i) {
+      if (ACTION_REGISTER_PLUGIN.equals(i.getAction())) {
+        pluginCN=(ComponentName)i.getParcelableExtra(EXTRA_COMPONENT);
+      }
+      else if (ACTION_DELIVER_CONTENT.equals(i.getAction())) {
+        RemoteViews rv=(RemoteViews)i.getParcelableExtra(EXTRA_CONTENT);
+        ViewGroup frame=(ViewGroup)findViewById(android.R.id.content);
+
+        frame.removeAllViews();
+
+        View pluginView=rv.apply(RemoteViewsHostActivity.this, frame);
+
+        frame.addView(pluginView);
+      }
+    }
+  };
+}

RemoteViews/Plugin/.classpath

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry kind="src" path="src"/>
+	<classpathentry kind="src" path="gen"/>
+	<classpathentry kind="con" path="com.android.ide.eclipse.adt.ANDROID_FRAMEWORK"/>
+	<classpathentry kind="con" path="com.android.ide.eclipse.adt.LIBRARIES"/>
+	<classpathentry kind="output" path="bin/classes"/>
+</classpath>