Why does the Android SDK complains when one of those things happens? Why does code that seems to be correct doesn’t work? Well, if your application stays frozen, your users could think it crashed. A few seconds is an eternity when you don’t have any feedback about what’s going on, and users are probably going to keep pressing buttons as a response, or close your application and never return. So, to prevent this, the Android SDK enforces minimum standards for responsiveness and display errors if those standards are not respected.<\/p>\n
To understand why the application freezes, we must take a look at the architecture of the application. By default, your Android application has only one thread<\/strong>, called the main thread. All you code execute on this single thread, and a thread can only do one thing at a time. <\/p>\n So, if you call the network and there is a delay, everything stops while the application waits for an answer, freezing your UI completely. You won’t even be able to display a progress bar because nothing else can run. The timeline looks like:<\/p>\n Fortunately, you can create new threads, which allow you to do more than one thing at once:<\/p>\n For one-time operations that only takes a few seconds, the easiest way to manage this is to use the AsyncTask<\/em> class available in the Android SDK. It will create a new thread for you that will do a specific task, and then notify you when that task is over so you can update your UI. <\/p>\n Here is an example of an AsycTask<\/em> that calls the GitHub API to calculate the number of repository that contains the “Android” string. While the query is running, a progress bar is shown in the UI.<\/p>\n And here is how you execute that task. In that case, it’s launched onCreate<\/em> event of the Activity<\/em> so the response is visible immediately in the layout, but it could be launched from anywhere else:<\/p>\n When you’re working with threads of any kinds, remember that updating the UI should only be done on the main thread. The Android SDK doesn’t support updating the UI from other threads, so you’ll likely have random crashes and weird behavior if you attempt it.<\/p>\n Also, as a caveat, Google doesn’t recommend relying on showing a progress bar exclusively for long-running operations. They believe that users should be able to keep working in the application and that you should manage what’s going on in the backend. <\/p>\n If you have a simple application that has only a few simple cases it may work, but if you have complex interactions between your data you can sink a lot of time trying to make everything work nicely together and handling what happens if an operation fails.<\/p>\n Still, you can start with a simple AsyncTask<\/em> and optimize as you go along. In most cases, it’s going to be a good starting point, but as soon you need to execute many tasks at once it won’t be enough. When you’re ready to go further with this, you should take a look at libraries such as RxJava<\/em> to help you manage your tasks.![\"\"](\"https:\/\/cindypotvin.com\/wp-content\/uploads\/2017\/03\/AsyncTask-SansAsync.png\")
<\/p>\n![\"\"](\"https:\/\/cindypotvin.com\/wp-content\/uploads\/2017\/03\/AsyncTask-AvecAsync.png\")
<\/p>\n\r\nprivate class GithubAndroidRepositoryQueryTask extends AsyncTask<String, Integer, String> {\r\n\r\n@Override\r\nprotected void onPreExecute() {\r\n super.onPreExecute();\r\n \/\/ Prepare the UI in the main UI thread before executing the task.\r\n mGitRepositoryProgressBar.setVisibility(View.VISIBLE);\r\n}\r\n\r\n@Override\r\nprotected String doInBackground(String... params) {\r\n \/\/ Do the operation on a new thread and returns the result. It calls the GitHub API to \r\n \/\/ calculate the number of repository that contains the Android string\r\n return getAndroidRepositoryCountFromGitHub();\r\n}\r\n\r\n@Override\r\nprotected void onProgressUpdate(Integer... progress) {\r\n \/\/ Could be used to update the main UI thread with the progress of the background\r\n \/\/ operation.\r\n}\r\n\r\n@Override\r\nprotected void onPostExecute(String result) {\r\n \/\/ Receive the result of the operation done in the new thread in the main UI thread and\r\n \/\/ use it to update the UI.\r\n super.onPostExecute(result);\r\n mGitRepositoryProgressBar.setVisibility(View.INVISIBLE);\r\n mGitRepositoryTextView.setText(result);\r\n}\r\n}\r\n<\/pre>\n\r\npublic class MainActivity extends AppCompatActivity {\r\n\r\n@Override\r\nprotected void onCreate(Bundle savedInstanceState) {\r\n super.onCreate(savedInstanceState);\r\n setContentView(R.layout.activity_main);\r\n mGitRepositoryTextView = (TextView) this.findViewById(R.id.github_repositories_tv);\r\n mGitRepositoryProgressBar = (ProgressBar) this.findViewById(R.id.github_repositories_pb);\r\n\r\n \/\/ Fires off an AsyncTask to get the number of Android repositories on GitHub and displays\r\n \/\/ it in the application.\r\n new GithubAndroidRepositoryQueryTask().execute();\r\n}\r\n<\/pre>\n
\n