Introduction into Android Development for the stupid.

1.4.1. TODO AndroidManifest.xml

<application
    android:allowBackup="true"
    android:something="meaningless"
    tools:targetApi="31">
    <activity
        bla-bla
</activity>
</application>

<application
    android:allowBackup="true"
    <!-- android:something="meaningless" -->
    tools:targetApi="31">
    <activity
        bla-bla
</activity>
</application>

1.4.2. TODO Объект R

1.4.3. TODO Activity

1. TODO Что такое Activity и как их писать.
   

   Activity – это базовый строительный блок Андроид-программ, в каком-то смысле "точка входа", функция main().

   Активити, вроде бы, должна обязательно занимать весь экран, или кусок разделённого экрана в более свежих Андроидах.

   Активити надо задекларировать в AndroidManifest.xml, и создать соответствующий ей класс в Java.

   <manifest ... >
     <application ... >
         <activity android:name=".ExampleActivity" />
         ...
     </application ... >
     ...
   </manifest >
   

   А одной программе может быть много активити.

   У Активити есть lifecycle, то есть, какие её методы вызываются в какой момент.

   Вот есть официальная диаграмма lifecycle:

   https://developer.android.com/reference/android/app/Activity#activity-lifecycle

   И есть неофициальная:

   https://github.com/xxv/android-lifecycle/

2. TODO Activity и GUI
   

   Поскольку андроидные люди большей частью пишут GUI, то львиная доля документации посвящена GUI.

   Поскольку обычный программист, пишущий программы для себя, позволить себе изощрённый GUI не может, это трудоёмко и обычно не очень нужно, то написанию GUI в этой методичке посвящён минимум.

   Тем не менее, хотя бы базового введения избежать не получится.

   Грубо говоря, GUI для андроида следует в общем тренде развития GUI в мире: есть программная часть и есть дизайнерская часть, которые более-менее совместимы.

   Дизайнерская часть рисуется графическим редактором, генерирующим xml. XML можно также писать вручную. Он хранится в каталоге res, и получать указатели на его элементы можно с помощью метода Activity.findViewById(R.id.bla).

   Например, у нас есть xml вида:

   <?xml version="1.0" encoding="utf-8"?>
   <androidx.constraintlayout.widget.ConstraintLayout
       xmlns:android="http://schemas.android.com/apk/res/android"
       xmlns:app="http://schemas.android.com/apk/res-auto"
       xmlns:tools="http://schemas.android.com/tools"
       android:id="@+id/main"
       android:layout_width="match_parent"
       android:layout_height="match_parent"
       tools:context=".MainActivity">
       <SurfaceView
           android:id="@+id/first_screen_view"
           android:layout_width="0dp"
           android:layout_height="0dp"
           android:layout_marginBottom="32dp"
           app:layout_constraintBottom_toTopOf="parent"
           app:layout_constraintEnd_toEndOf="parent"
           app:layout_constraintStart_toStartOf="parent"
           app:layout_constraintTop_toTopOf="parent" />
   </androidx.constraintlayout.widget.ConstraintLayout>
   

   .MainActivity – это активити, на котором есть ConstraintLayout с id main, внутри которого есть единственный холст SurfaceView с id first_screen_view.

   Нотация у Google как всегда отвратительная. Во-первых, все виджеты унаследованы от View. Почему виджет называется View – за гранью моего понимания, ведь они не являются отображением никаких данных.

   ConstraintLayout – это тоже View, то есть, виджет, по плану Google предназначенный, чтобы содержать другие виджеты. Зачем так делать, совершенно непонятно. Логично было бы сделать какой-нибудь Container с мембером типа LayoutAlgorithm, и он бы все внутренние виджеты разложил так, как умеет, и заменой его можно было бы адаптироваться под разные дизайны и размеры экранов. Но, как всегда, Андроид – полное говно.

   1. Binding
      

      Ну, конечно, получать указатели на виджеты с помощью findViewById глупо и неудобно, поэтому Google таки придумал механизм binding, пусть и не сразу.

      https://developer.android.com/topic/libraries/data-binding

      По-моему, в С++ такое было ещё в Boland C++ VCL?

      Binding включается в build.gradle:

      dataBinding {
          enabled true
      }
      

      А в java коде пишется:

      import my.package.name.ActivityNameBinding;
      import androidx.databinding.DataBindingUtil;
      
      public class NameActiviy extends AppCompatActivity {
        private ActivityNameBinding binding;
        public void onCreate () {
          this.binding = DataBindingUtil.setContentView(this, R.layout.activity_name);
      
        }
      }
      

      И тогда можно писать проще, без findViewById.

      this.binding.first_screen_view
      .setOnClickListener((final View v) -> { Log.i("bla", "bla");});
      

3. TODO IPC между разными Activity
   

   Активити могут получать на вход аргументы, примерно как функция main. Для этого надо в том же xml задекларировать эти аргументы (они называются Intent), а в самой активити написать обработчик.

   <intent-filter>
       <action android:name="android.intent.action.SEND" />
       <category android:name="android.intent.category.DEFAULT" />
       <data android:mimeType="text/plain" />
   </intent-filter>
   

   Указанный выше код означает, что активити может получать аргументы с типом "android.intent.action.SEND".

   <intent-filter>
     <action android:name="android.intent.action.MAIN" />
     <category android:name="android.intent.category.LAUNCHER" />
   </intent-filter>
   

   Указанный выше код означает, что активити будет запускаться по клику на иконку на рабочем столе.

   Как запустить эту активити из другого приложения?

   // Create the text message with a string
   Intent argvBox = new Intent();
   argvBox.setAction(Intent.ACTION_SEND);
   argvBox.setType("text/plain");
   argvBox.putExtra(Intent.EXTRA_TEXT, "<switch 1> <switch 2> <file name>");
   // Start the activity
   this.startActivity(argvBox);
   

   Код сверху очень общий и будет запускать любые активити, заявляющие, что поддерживают android.intent.action.SEND и категорией android.intent.category.DEFAULT. Наверное, можно и свои собственные типы сообщений определять, я ещё не разобрался. Код сверху можно запускать из любых функций в первой активити. Но как его обработать?

   Вот так:

   public class SecondActivity extends AppCompatActivity {
       @Override
       protected void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           this.setContentView(R.layout.activity_second);
           ((TextView) this.findViewById(R.id.first_text_field)).setText("Unset in code");
           ((TextView) this.findViewById(R.id.first_text_field))
                   .setText(this.getIntent()
   /                .getStringExtra(android.content.Intent.EXTRA_TEXT));
   }}
   

   Нужно при создании активити вытащить argv из интента, и потом с ней можно делать что нужно. Обратите внимание на следующие вещи:

   1. onCreate – это не конструктор. Ну, потому что в Google ненавидят RAII и считают, что конструкторы придумали глупые люди.
   2. Заранее предполагается, что активити сериализуема, поэтому на вход всегда подаётся Bundle, даже если нам вообще это не нужно.
   3. argv передаётся через "глобальную переменную" (ну, глобальную для активити), Intent, получаемый через аналог getenv, getIntent.
   4. .getStringExtra(android.content.Intent.EXTRA_TEXT) – это вообще какой-то полный маразм.

   Этот код можно написать только в onCreate, потому что ну… дебилы проектировали, чо. Несмотря на навороченный Lifecycle активити (https://developer.android.com/guide/components/activities/intro-activities#mtal), метода onReceiveIntent у неё нет.

4. TODO Как отправить ответ обратно вопрошающему?
   

   Ну, мне это особенно не было нужно, мне ответ отправляли чужие активити, но чисто ради интереса:

   this.setResult (int resultCode, Intent data);
   this.finish();
   

   Внимание: на этом активити умрёт, будет уничтожена. (Смотри диаграмму https://developer.android.com/reference/android/app/Activity#activity-lifecycle )

   Почему так странно сделано? Хрен его знает, если честно. Чтобы не гонять разные активити в разных тредах?

   Заметьте, что на диаграмме нет onActivityResult. Почему? Ну, говно документация у Google, чего.

   Вот диаграмма, где он есть:

   

5. TODO Как получить результат из вызова Activity
   

   Итак, мы вызвали активити с аргументом, но текущий вариант не позволяет нам получить ответ от второй активити каким-то разумным способом. То есть, если активити принадлежит нам же, то мы можем и вызвать первую активити из второй, точно так же, через интент. Но что, если активити принадлежит не нам, а ответ получить всё равно надо?

   Тут есть два способа.

   1. TODO startActivityForResult.
      

      startActivityForResult работает точно так же, как startActivity, но предполагает, что ответ нам вернут. Для примера я запрошу доступ к записи экрана.

      final int REQUEST_MEDIA_PROJECTION_CODE = 1;
      this.startActivityForResult(
          this.getSystemService(Context.MEDIA_PROJECTION_SERVICE).createScreenCaptureIntent(),
          REQUEST_MEDIA_PROJECTION_CODE);
      

      Что за чушь тут происходит?

      startActivityForResult получает на вход интент и тэг, который мы потом будем использовать для опознавания результата, который нам вернёт другая активити. Этот интент мы конструируем не сами, а просим систему подготовить для нас.

      Вопрос: если мы всё равно просим систему подготовить для нас специальный интент, который только для захвата экрана и годится, то зачем городить огород с самодельной отправкой этого интента через startActivityForResult? Ну, почему-почему, говнокод, вот почему.

      Ну хорошо, ладно, допустим мы отправляем запрос так, но зачем нам помечать этот запрос через отдельный параметр в функции, почему нельзя записать прямо в интент, что делать с ответом на запрос? Ну, почему-почему, говнокод, вот почему.

      Отдельно стоит заметить, что про класс Context мы пока не говорили, но в данном случае это можно для ясности замять, просто упомянуть, что это пример антипаттерна "God object", через который можно вызывать много функций операционной системы.

      Теперь как получить результат запроса?

      @Override
          public void onActivityResult(int requestCode, int resultCode, Intent data) {
              super.onActivityResult(requestCode, resultCode, data);
              Log.i("onActivityResult", "receiving result");
      
              if (requestCode == REQUEST_MEDIA_PROJECTION_CODE) {
                  if (resultCode != Activity.RESULT_OK) {
                      Log.i("Permission", "Failed to get permission.");
                      return;
                  }
                  this.mProjectionPermissionResultCode = resultCode;
                  this.mProjectionPermissionResultData = data;
              }
          }
      

      Что? Это делается в другой функции? И результат можно получить только переда его через глобальные (для модуля) переменные? Но нахуя? Что это за говно вообще?

      Больше того, несмотря на то, что результат получается не просто в посторонней, а прямо таки в захардкоженной функции, диспетчеризация вызовов в Android Java асинхронная, но не параллельная. То есть, в вызывающей функции нельзя "подождать" пока ответ от второй активити вернётся и будет обработан в onActivityResult. Ну, если только самому не запускать отдельно тред.

      Что нам говорит Google на эту тему?

      When starting an activity for a result, it is possible—and, in cases of memory-intensive operations such as camera usage, almost certain—that your process and your activity will be destroyed due to low memory.

      А что будет с тредом, интересно, если Андроид и правда убъёт активити при переключении на камеру?

      В общем, без тредов, но мы попробуем сделать continuations для бедных.

      В нашей активити добавляем три глобальные переменные, через которые будем перекидывать данные, и пишем функцию:

      private static final int REQUEST_MEDIA_PROJECTION_CODE = 1;
      private static int mProjectionPermissionResultCode = -1;
      private static Intent mProjectionPermissionResultData = null;
      private static boolean mPermissionReceived = false;
      
      public void startScreenCast() {
        actuallyStartScreenCast();
      }
      @Override
        public void onActivityResult(int requestCode, int resultCode, Intent data) {
            super.onActivityResult(requestCode, resultCode, data);
            if (requestCode == REQUEST_MEDIA_PROJECTION_CODE) {
                if (resultCode != Activity.RESULT_OK) {
                    Log.i("Permission", "Failed to get permission.");
                    return;
                }
                this.mProjectionPermissionResultCode = resultCode;
                this.mProjectionPermissionResultData = data;
                this.mPermissionReceived = true;
                actuallyStartScreenCast();
            }
        }
      public void actuallyStartScreenCast() {
            MediaProjectionManager mediaProjectionManager =
                  (MediaProjectionManager)
                          this.getSystemService(Context.MEDIA_PROJECTION_SERVICE);
          if (this.mPermissionReceived == false) {
              this.startActivityForResult(
                      mediaProjectionManager.createScreenCaptureIntent(),
                      REQUEST_MEDIA_PROJECTION_CODE);
              return; // cannot do more, but will be called again when permission arrives.
          } else {
              MediaProjection mediaProjection = mediaProjectionManager.getMediaProjection(
                      mProjectionPermissionResultCode,
                      mProjectionPermissionResultData);
              assert mediaProjection != null : "Media projection is null";
              android.view.SurfaceView sv = this.findViewById(R.id.first_screen_view);
              assert sv != null : "SurfaceView is null";
              android.view.Surface s = sv.getHolder().getSurface();
              assert s != null : "Surface is null";
              DisplayMetrics metrics = new DisplayMetrics();
              this.getWindowManager().getDefaultDisplay().getMetrics(metrics); // Mutates!
              int dpi = metrics.densityDpi;
              VirtualDisplay mVirtualDisplay = mediaProjection.createVirtualDisplay("ScreenCapture",
                      sv.getWidth(), sv.getHeight(), dpi,
                      DisplayManager.VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR,
                      s, null, null);
          }
      }
      

      Это работает, но в целом, этот идиотский проброс функций, как будто авторы очень хотели существования continuations, но не знали, как их сделать.

      1. startScreenCast
      2. actuallyStartScreenCast
      3. onActivityResult
      4. actuallyStartScreenCast

      Скринкаст тут выбран в силу того, что этот процесс, хотя и требует авторизации юзером, но не требует прописывания пермишшенов в манифест, что приятно, потому что мы этого ещё не проходили.

6. TODO Activity Result API
   

   https://www.geeksforgeeks.org/how-to-use-activityforresultluncher-as-startactivityforresult-is-deprecated-in-android/

   So, the new API looks much better. No stupid uniform onActivityResult, and while we still cannot obtain the permission synchronously, we can do it in 2 parts instead of 4.

                   @Override
                   protected void onCreate(Bundle savedInstanceState) {
                     super.onCreate(savedInstanceState);
                     this.setContentView(R.layout.activity_main);
                     ((android.widget.Button) this.findViewById(R.id.button_capture2)).setText("Click me");
                     ((android.widget.Button) this.findViewById(R.id.button_capture2))
                         .setOnClickListener(
                             (android.view.View v) -> {
                               (this.registerForActivityResult(
                                   new ActivityResultContracts.StartActivityForResult(),
                                   result -> {
                                     if (result.getResultCode() == RESULT_OK) {
                                       assert result.getData() != null : "Getting permission failed!";
                                       Intent data = result.getData();
                                       MediaProjection m = ((MediaProjectionManager)
                                                            this.getSystemService(
                                                                Context.MEDIA_PROJECTION_SERVICE))
                                                           .getMediaProjection(result.getResultCode(),
                                                                               result.getData());
                                       assert m != null : "Media projection is null";
                                       android.view.SurfaceView sv = this
                                                                     .findViewById(R.id.first_screen_view);
                                       assert sv != null : "SurfaceView is null";
                                       android.view.Surface s = sv.getHolder().getSurface();
                                       assert s != null : "Surface is null";
                                       DisplayMetrics metrics = new DisplayMetrics();
                                       this.getWindowManager()
                                           .getDefaultDisplay().getMetrics(metrics); // Mutates metrics!
                                       int dpi = metrics.densityDpi;
                                       VirtualDisplay mVirtualDisplay = m
                                        .createVirtualDisplay(
                                            "ScreenCapture",
                                            sv.getWidth(),
                                            sv.getHeight(),
                                            dpi,
                                            DisplayManager.VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR,
                                            s, null, null);}}))
                              .launch(((MediaProjectionManager)this
                                       .getSystemService(Context.MEDIA_PROJECTION_SERVICE))
                                      .createScreenCaptureIntent());
                             });
   }
   

   Right? All in one method, all local, and the response is registered right where it is received.

   LifecycleOwner com.example.myscreengrabber.MainActivity@483cf7c is attempting to register while current state is RESUMED. LifecycleOwners must call register before they are STARTED.

   You must be kidding me, right?

   https://stackoverflow.com/questions/64476827/how-to-resolve-the-error-lifecycleowners-must-call-register-before-they-are-sta

   @Override
   protected void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
     this.setContentView(R.layout.activity_main);
     ((android.widget.Button) this.findViewById(R.id.first_button)).setText("Click me");
     ((androidx.appcompat.widget.AppCompatButton) this.findViewById(R.id.first_button)).setOnClickListener(
         (android.view.View v) -> {
           Log.i("button", "lwf:clicked button");
           String argv = "My wonderful text sent in an intent";
           android.content.Intent argvBox = new android.content.Intent();
           argvBox.setAction(android.content.Intent.ACTION_SEND);
           argvBox.setType("text/plain");
           argvBox.putExtra(android.content.Intent.EXTRA_TEXT, argv);
           startActivity(argvBox);
         });
     ((android.widget.Button) this.findViewById(R.id.button_screen)).setOnClickListener(
         (android.view.View v) -> {
           todoScreenCast();
         });
     var caller =
         (this.registerForActivityResult(
             new ActivityResultContracts.StartActivityForResult(),
             result -> {
               if (result.getResultCode() == RESULT_OK) {
                 assert result.getData() != null : "Getting permission failed!";
                 Intent data = result.getData();
                 MediaProjection m = ((MediaProjectionManager)
                                      this.getSystemService(Context.MEDIA_PROJECTION_SERVICE))
                                     .getMediaProjection(result.getResultCode(),
                                                         result.getData());
                 assert m != null : "Media projection is null";
                 android.view.SurfaceView sv = this.findViewById(R.id.first_screen_view);
                 assert sv != null : "SurfaceView is null";
                 android.view.Surface s = sv.getHolder().getSurface();
                 assert s != null : "Surface is null";
                 DisplayMetrics metrics = new DisplayMetrics();
                 this.getWindowManager().getDefaultDisplay().getMetrics(metrics); // Mutates!
                 int dpi = metrics.densityDpi;
                 VirtualDisplay mVirtualDisplay =
                     m.createVirtualDisplay("ScreenCapture",
                                            sv.getWidth(),
                                            sv.getHeight(),
                                            dpi,
                                           DisplayManager.VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR,
                                           s, null, null);
               }}));
     ((android.widget.Button) this.findViewById(R.id.button_capture2)).setOnClickListener(
         (android.view.View v) -> {
           caller.launch(((MediaProjectionManager)
                          this.getSystemService(Context.MEDIA_PROJECTION_SERVICE))
                         .createScreenCaptureIntent());
         });
   }
   

   Okay, this is stupid, but not criminally stupid. At least there is no "universal dispatcher" for return values.

1.4.4. TODO Permissions

1.7.1. TODO Bundle

1.7.2. TODO Persistent notifications

1.7.3. TODO Threads and Alarms

1.7.4. TODO Providers and shitty VFS

1.7.5. TODO Jetpack Compose

1. TODO Support library
   
2. TODO Fragment
   
3. TODO AppCompat