Stats provider example

app/build.gradle

@@ -26,6 +26,10 @@ android {
  signingConfig signingConfigs.release
  }
  }
+ compileOptions {
+ sourceCompatibility JavaVersion.VERSION_1_8
+ targetCompatibility JavaVersion.VERSION_1_8
+ }
 }
 
 dependencies {

app/src/main/AndroidManifest.xml

@@ -1,13 +1,17 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
+ xmlns:tools="http://schemas.android.com/tools"
  package="com.ichi2.apisample" >
+ <uses-permission android:name="com.ichi2.anki.permission.READ_DATABASE"/>
+ <uses-permission android:name="com.ichi2.anki.permission.READ_WRITE_DATABASE"/>
 
  <application
  android:allowBackup="true"
  android:fullBackupContent="true"
  android:icon="@mipmap/ic_launcher"
  android:label="@string/app_name"
- android:theme="@style/Theme.AppCompat" >
+ android:theme="@style/Theme.AppCompat"
+ tools:ignore="GoogleAppIndexingWarning">
  <activity
  android:name=".MainActivity"
  android:label="@string/app_name" >
@@ -17,6 +21,10 @@
  <category android:name="android.intent.category.LAUNCHER" />
  </intent-filter>
  </activity>
+ <activity
+ android:name=".StatsActivity"
+ android:label="@string/card_counts" >
+ </activity>
  </application>
 
 </manifest>

app/src/main/java/com/ichi2/apisample/AnkiDroidHelper.java

@@ -25,6 +25,10 @@ public class AnkiDroidHelper {
  private static final String DECK_REF_DB = "com.ichi2.anki.api.decks";
  private static final String MODEL_REF_DB = "com.ichi2.anki.api.models";
 
+ // Temporary until new API is published and we can import static as with READ_WRITE_PERMISSION
+ public static final String READ_PERMISSION = "com.ichi2.anki.permission.READ_DATABASE";
+
+
  private AddContentApi mApi;
  private Context mContext;
 
@@ -46,22 +50,42 @@ public static boolean isApiAvailable(Context context) {
  return AddContentApi.getAnkiDroidPackageName(context) != null;
  }
 
+ /**
+ * Whether or not we should request read-only access to the AnkiDroid API
+ */
+ public boolean shouldRequestReadPermission() {
+ if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {
+ return false;
+ }
+ return shouldRequestReadWritePermission()
+ || ContextCompat.checkSelfPermission(mContext, READ_PERMISSION) != PackageManager.PERMISSION_GRANTED;
+ }
+
  /**
  * Whether or not we should request full access to the AnkiDroid API
  */
- public boolean shouldRequestPermission() {
+ public boolean shouldRequestReadWritePermission() {
  if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {
  return false;
  }
  return ContextCompat.checkSelfPermission(mContext, READ_WRITE_PERMISSION) != PackageManager.PERMISSION_GRANTED;
  }
 
+ /**
+ * Request permission from the user for read-only access to the AnkiDroid API (for SDK 23+)
+ * @param callbackActivity An Activity which implements onRequestPermissionsResult()
+ * @param callbackCode The callback code to be used in onRequestPermissionsResult()
+ */
+ public void requestReadPermission(Activity callbackActivity, int callbackCode) {
+ ActivityCompat.requestPermissions(callbackActivity, new String[]{READ_PERMISSION}, callbackCode);
+ }
+
  /**
  * Request permission from the user to access the AnkiDroid API (for SDK 23+)
  * @param callbackActivity An Activity which implements onRequestPermissionsResult()
  * @param callbackCode The callback code to be used in onRequestPermissionsResult()
  */
- public void requestPermission(Activity callbackActivity, int callbackCode) {
+ public void requestReadWritePermission(Activity callbackActivity, int callbackCode) {
  ActivityCompat.requestPermissions(callbackActivity, new String[]{READ_WRITE_PERMISSION}, callbackCode);
  }
 

app/src/main/java/com/ichi2/apisample/MainActivity.java

@@ -80,6 +80,9 @@ public boolean onCreateOptionsMenu(Menu menu) {
  @Override
  public boolean onOptionsItemSelected(MenuItem item) {
  switch (item.getItemId()) {
+ case R.id.stats_menu_item:
+ startActivity(new Intent(this, StatsActivity.class));
+ return true;
  default:
  return super.onOptionsItemSelected(item);
  }
@@ -216,8 +219,8 @@ public boolean onMenuItemClick(MenuItem item) {
  // Handle when the submenu items are clicked
  if (item.getItemId() == ANKIDROID_INSTANT_ADD) {
  // Request permission to access API if required
- if (mAnkiDroid.shouldRequestPermission()) {
- mAnkiDroid.requestPermission(MainActivity.this, AD_PERM_REQUEST);
+ if (mAnkiDroid.shouldRequestReadWritePermission()) {
+ mAnkiDroid.requestReadWritePermission(MainActivity.this, AD_PERM_REQUEST);
  return true;
  }
  // Add all data using AnkiDroid provider

app/src/main/java/com/ichi2/apisample/StatsActivity.java

@@ -0,0 +1,71 @@
+package com.ichi2.apisample;
+
+import android.content.ContentResolver;
+import android.content.pm.PackageManager;
+import android.database.Cursor;
+import android.net.Uri;
+import android.os.Bundle;
+import android.widget.TextView;
+import android.widget.Toast;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.appcompat.app.AppCompatActivity;
+import androidx.core.app.ActivityCompat;
+
+public class StatsActivity extends AppCompatActivity implements ActivityCompat.OnRequestPermissionsResultCallback {
+
+ private static final int AD_PERM_REQUEST = 0;
+ private AnkiDroidHelper mAnkiDroid;
+
+ @Override
+ protected void onCreate(@Nullable Bundle savedInstanceState) {
+ super.onCreate(savedInstanceState);
+
+ mAnkiDroid = new AnkiDroidHelper(this);
+
+ setContentView(R.layout.activity_stats);
+ if (!AnkiDroidHelper.isApiAvailable(this)) {
+ Toast.makeText(this, R.string.api_not_available, Toast.LENGTH_LONG).show();
+ finishActivity(-1);
+ return;
+ }
+
+ if (mAnkiDroid.shouldRequestReadPermission()) {
+ mAnkiDroid.requestReadPermission(this, AD_PERM_REQUEST);
+ } else {
+ displayCardCount();
+ }
+ }
+
+ private void displayCardCount() {
+ TextView matureText = findViewById(R.id.count_mature);
+ TextView youngText = findViewById(R.id.count_young);
+ TextView newCount = findViewById(R.id.count_new);
+ TextView suspendedCount = findViewById(R.id.count_suspended);
+
+ Cursor countCursor = fetchCardCount();
+
+ matureText.setText(getString(R.string.mature_cards, countCursor.getInt(0)));
+ youngText.setText(getString(R.string.young_cards, countCursor.getInt(1)));
+ newCount.setText(getString(R.string.new_cards, countCursor.getInt(2)));
+ suspendedCount.setText(getString(R.string.suspended_cards, countCursor.getInt(3)));
+ }
+
+ private Cursor fetchCardCount() {
+ ContentResolver resolver = getApplicationContext().getContentResolver();
+ Cursor countCursor = resolver.query(Uri.parse("content://com.ichi2.anki.stats/cardcount"), null, null, null, null);
+ countCursor.moveToFirst();
+ return countCursor;
+ }
+
+
+ public void onRequestPermissionsResult (int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
+ if ((requestCode == AD_PERM_REQUEST) && (grantResults[0] == PackageManager.PERMISSION_GRANTED)) {
+ displayCardCount();
+ } else {
+ Toast.makeText(this, R.string.permission_denied, Toast.LENGTH_LONG).show();
+ finishActivity(-1);
+ }
+ }
+}

app/src/main/res/layout/activity_stats.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+ android:orientation="vertical"
+ android:layout_width="match_parent"
+ android:paddingLeft="16dp"
+ android:paddingRight="16dp"
+ android:paddingTop="16dp"
+ android:paddingBottom="16dp"
+ android:layout_height="match_parent">
+ <TextView
+ android:id="@+id/count_mature"
+ android:visibility="visible"
+ android:layout_width="match_parent"
+ android:layout_height="50dp"/>
+ <TextView
+ android:id="@+id/count_young"
+ android:visibility="visible"
+ android:layout_width="match_parent"
+ android:layout_height="50dp"/>
+ <TextView
+ android:id="@+id/count_new"
+ android:visibility="visible"
+ android:layout_width="match_parent"
+ android:layout_height="50dp"/>
+ <TextView
+ android:id="@+id/count_suspended"
+ android:visibility="visible"
+ android:layout_width="match_parent"
+ android:layout_height="50dp"/>
+</LinearLayout>

app/src/main/res/menu/main_menu.xml

@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <menu xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:app="http://schemas.android.com/apk/res-auto">
- <item android:id="@+id/settings"
+ <item android:id="@+id/stats_menu_item"
  app:showAsAction="never"
- android:visible="false"
- android:title="@string/settings"/>
+ android:visible="true"
+ android:title="@string/card_counts"/>
 </menu>

app/src/main/res/values/strings.xml

@@ -7,5 +7,11 @@
  <string name="n_items_selected">%d items selected</string>
  <string name="n_items_added">%d items added to AnkiDroid</string>
  <string name="card_add_fail">Error adding cards to AnkiDroid</string>
+ <string name="api_not_available">AnkiDroid API not available</string>
  <string name="permission_denied">Couldn\'t get permission to access the AnkiDroid database</string>
+ <string name="card_counts">Card Counts</string>
+ <string name="mature_cards">Mature cards %d</string>
+ <string name="young_cards">Young cards %d</string>
+ <string name="new_cards">New cards %d</string>
+ <string name="suspended_cards">Suspended cards %d</string>
 </resources>