HelpUtils.java

/*
 * Copyright 2014 Google 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.
 */

package org.devconmyanmar.apps.devcon.utils;

import android.app.Activity;
import android.app.AlertDialog;
import android.app.Dialog;
import android.app.DialogFragment;
import android.app.Fragment;
import android.app.FragmentManager;
import android.app.FragmentTransaction;
import android.content.Context;
import android.content.DialogInterface;
import android.content.Intent;
import android.content.pm.PackageInfo;
import android.content.pm.PackageManager;
import android.os.Bundle;
import android.text.Html;
import android.text.SpannableString;
import android.text.SpannableStringBuilder;
import android.text.method.LinkMovementMethod;
import android.text.style.ClickableSpan;
import android.view.LayoutInflater;
import android.view.View;
import android.webkit.WebView;
import android.widget.TextView;
import org.devconmyanmar.apps.devcon.R;
import org.devconmyanmar.apps.devcon.ui.ContributorsActivity;

/**
 * This is a set of helper methods for showing contextual help information in the app.
 */
public class HelpUtils {
  public static void showAbout(Activity activity) {
    FragmentManager fm = activity.getFragmentManager();
    FragmentTransaction ft = fm.beginTransaction();
    Fragment prev = fm.findFragmentByTag("dialog_about");
    if (prev != null) {
      ft.remove(prev);
    }
    ft.addToBackStack(null);

    new AboutDialog().show(ft, "dialog_about");
  }

  public static void showOpenSourceLicenses(Activity activity) {
    FragmentManager fm = activity.getFragmentManager();
    FragmentTransaction ft = fm.beginTransaction();
    Fragment prev = fm.findFragmentByTag("dialog_licenses");
    if (prev != null) {
      ft.remove(prev);
    }
    ft.addToBackStack(null);

    new OpenSourceLicensesDialog().show(ft, "dialog_licenses");
  }

  public static class AboutDialog extends DialogFragment {

    private static final String VERSION_UNAVAILABLE = "N/A";

    public AboutDialog() {
    }

    @Override public Dialog onCreateDialog(Bundle savedInstanceState) {
      // Get app version
      PackageManager pm = getActivity().getPackageManager();
      String packageName = getActivity().getPackageName();
      String versionName;
      try {
        PackageInfo info = pm.getPackageInfo(packageName, 0);
        versionName = info.versionName;
      } catch (PackageManager.NameNotFoundException e) {
        versionName = VERSION_UNAVAILABLE;
      }

      // Build the about body view and append the link to see OSS licenses
      SpannableStringBuilder aboutBody = new SpannableStringBuilder();
      aboutBody.append(Html.fromHtml(getString(R.string.about_body, versionName)));

      SpannableString contributorsLink =
          new SpannableString(getString(R.string.about_contributors));

      contributorsLink.setSpan(new ClickableSpan() {
        @Override public void onClick(View view) {
          Intent i = new Intent(getActivity(), ContributorsActivity.class);
          i.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
          startActivity(i);
        }
      }, 0, contributorsLink.length(), 0);
      aboutBody.append("\n\n");
      aboutBody.append(contributorsLink);

      SpannableString licensesLink = new SpannableString(getString(R.string.about_licenses));
      licensesLink.setSpan(new ClickableSpan() {
        @Override public void onClick(View view) {
          HelpUtils.showOpenSourceLicenses(getActivity());
        }
      }, 0, licensesLink.length(), 0);
      aboutBody.append("\n");
      aboutBody.append(licensesLink);

      LayoutInflater layoutInflater =
          (LayoutInflater) getActivity().getSystemService(Context.LAYOUT_INFLATER_SERVICE);
      TextView aboutBodyView = (TextView) layoutInflater.inflate(R.layout.dialog_about, null);
      aboutBodyView.setText(aboutBody);
      aboutBodyView.setMovementMethod(new LinkMovementMethod());

      return new AlertDialog.Builder(getActivity()).setTitle(R.string.title_about)
          .setView(aboutBodyView)
          .setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() {
            public void onClick(DialogInterface dialog, int whichButton) {
              dialog.dismiss();
            }
          })
          .create();
    }
  }

  public static class OpenSourceLicensesDialog extends DialogFragment {

    public OpenSourceLicensesDialog() {
    }

    @Override public Dialog onCreateDialog(Bundle savedInstanceState) {
      WebView webView = new WebView(getActivity());
      webView.loadUrl("file:///android_asset/licenses.html");

      return new AlertDialog.Builder(getActivity()).setTitle(R.string.about_licenses)
          .setView(webView)
          .setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() {
            public void onClick(DialogInterface dialog, int whichButton) {
              dialog.dismiss();
            }
          })
          .create();
    }
  }
}