.. java:import:: android.annotation SuppressLint

.. java:import:: android.content Intent

.. java:import:: android.graphics.drawable Drawable

.. java:import:: android.os Bundle

.. java:import:: com.idopte.scmiddleware Log

.. java:import:: android.view Menu

.. java:import:: android.view MenuItem

.. java:import:: android.webkit JavascriptInterface

.. java:import:: android.webkit WebView

.. java:import:: androidx.annotation MainThread

.. java:import:: androidx.annotation NonNull

.. java:import:: androidx.appcompat.app ActionBar

.. java:import:: androidx.appcompat.app AppCompatActivity

.. java:import:: androidx.core.content ContextCompat

.. java:import:: com.idopte.scmapi SCMException

.. java:import:: com.idopte.scmapi Util

.. java:import:: com.idopte.scmapiembed SCMHelper

.. java:import:: com.idopte.scmiddleware SCWSSystem

.. java:import:: com.idopte.scmjavaapi R

ManagerActivity
===============

.. java:package:: com.idopte.scmapi.ui
   :noindex:

.. java:type:: public class ManagerActivity extends AppCompatActivity

   \ ``ManagerActivity``\  is an activity which displays Idopte Manager GUI in a \ ``WebView``\ .

   \ **Use case 1: start activity**\

   To use Idopte Manager GUI, you can directly start this activity in your application from another activity:

   .. parsed-literal::

      Intent managerActivity = new Intent(this, com.idopte.scmapi.ui.ManagerActivity.class);
      startActivity(managerActivity);

   You do not need to add any activity in the application ``AndroidManifest.xml`` file. Everything is managed by the SDK.

   \ ``ManagerActivity``\  is destroyed when the user clicks the **white cross on the action bar**.

   Note that ``idopte_manager.xml`` layout file is internally used. To avoid any conflict, you **should not** have a layout file with this name in your application.

   All the required initializations (card system, HTTP server...) are handled internally with this use case.

   \ **Use case 2: directly load manager in a WebView**\

   You can also just use \ :java:ref:`ManagerActivity.loadManager(WebView,ManagerCallbacks)`\  and \ :java:ref:`ManagerActivity.exitManager(WebView)`\  static methods to directly load manager:

   .. parsed-literal::

      public class MyActivity extends AppCompatActivity implements ManagerActivity.ManagerCallbacks {
          private WebView webView = null;

          \@Override
          protected void onCreate(Bundle savedInstanceState) {
              super.onCreate(savedInstanceState);
              setContentView(R.layout.activity_manager);

              // initialize all SCM stuff
              SCMHelper.observableActivityCreated(this);

              // load Manager GUI
              webView = findViewById(R.id.web_view_manager_id);
              try {
                  ManagerActivity.loadManager(webView, this);
              } catch (SCMException e) {
                  e.printStackTrace();
              }
          }

          \@Override
          protected void onDestroy() {
              super.onDestroy();

              // exit Manager
              ManagerActivity.exitManager(webView);
          }

          \@Override
          \@JavascriptInterface
          public void updateTitle(String title) {
              // ...
          }

          \@Override
          \@JavascriptInterface
          public void showBackButton(boolean show) {
              // ...
          }
      }

   Note that SCM initializations must be done before loading manager GUI.

Methods
-------
exitManager
^^^^^^^^^^^

.. java:method:: public static void exitManager(WebView webView)
   :outertype: ManagerActivity

   Exits Idopte Manager GUI, previously loaded with given \ ``WebView``\  through \ :java:ref:`ManagerActivity.loadManager(WebView,ManagerCallbacks)`\ .

   :param webView: object in which was displayed *Idopte Manager GUI*.

loadManager
^^^^^^^^^^^

.. java:method:: @SuppressLint @MainThread public static void loadManager(WebView webView, ManagerCallbacks managerCallbacks) throws SCMException
   :outertype: ManagerActivity

   Loads Idopte Manager GUI in given \ ``WebView``\ , without needing instantiate a \ ``ManagerActivity``\ .

   JavaScript execution in given \ ``WebView``\  is enabled. All the required initializations (card system, HTTP server...) must be done by the caller, through \ :java:ref:`com.idopte.scmapiembed.SCMHelper`\  methods for instance.

   :param webView: object in which will be displayed *Idopte Manager GUI*.
   :param managerCallbacks: interface to use which defines some callbacks.

   **See also:** :java:ref:`ManagerActivity.exitManager(WebView)`

onBackButtonPressed
^^^^^^^^^^^^^^^^^^^

.. java:method:: public static void onBackButtonPressed(WebView webView)
   :outertype: ManagerActivity

   Triggers action to run when back button is pressed, in Idopte Manager navigation.

   This method must be called when back button defined in \ :java:ref:`ManagerCallbacks.showBackButton(boolean)`\  is pressed by the user.

   :param webView: the ``WebView`` previously used with \ :java:ref:`ManagerActivity.loadManager(WebView,ManagerCallbacks)`\ .