Author Topic: FAQ: proposed additions and changes  (Read 4698 times)

StR

  • Hero Member
  • *****
  • Posts: 1558
FAQ: proposed additions and changes
« on: September 16, 2016, 11:29:41 pm »
Kostya:

If I may, - in the past 2-3 months, many questions were asked where two big issues may play the role:
A. Push being enabled in all 3 places (it was IMAP push before, now Exchange push as well).
B. Battery optimizations from all three sources ((i)Android Doze, (ii)OEMs, (iii)3rd party apps).

I know that the FAQ has: (A) How do I enable IMAP Push ? and (B) Persistent network errors or the app not checking mail, MIUI, Huawei.

With respect to (A), - may I suggest to extend this description to IMAP Push? (And I understand if you want to wait until it goes into the "mainstream" "Release" branch.
Also, maybe you can consider rephrasing slightly the existing Answer, so that it is explicitly and unambiguously that Push must be enabled in 3 places.
At present, it says so, but through listing and describing all three places. And some people tend to skip/miss one of them.

If I were doing that, I'd just add a "summary" sentence at the very beginning of it: "Push must be enabled (configured) in 3 places: (1) for the entire app, (2) for the specific account, and (3) for the specific folder(s)." And then, I'd add the corresponding numbers at the beginning of each paragraph (1-3).


With respect to (B), battery optimization Answer:
It covers primarily MIUI and Huawei's (so it is a part of B(ii)).
Somewhere in the middle, it has a sentence:
"Even if your phone is not a Xiaomi with MIUI, if you get “persistent network errors” or the app isn’t checking mail, it could be caused by same type of “battery optimizer” (an app or something built-in) which blocks the app’s access to the network when it’s in the background."
But it is buried in the middle, and if people have, say, Samsung (or who else does that?) - they might not open the Q/A.

And the issue of B(i) Doze and B(iii) are not covered in the FAQ.

So, I'd suggest (sorry for repeating it, - I mentioned that a few weeks ago, not sure if you've seen it between your absences):
(a) Add the description for B(i) and (iii)
(b) Expand on B(ii), by adding mentions of other OEMs if you know, - and adding something like "and other manufacturers" in the item headline ("Question")
(c) Have an "umbrella" Q/A for all three of them. The logic is that when people do trouble-shooting they find: "If messages don't sync (push or scheduled sync), it might be due to battery optimization that could be happening at 3 different levels: (i), (ii), (iii)... See the recommendations on how to deal with each of them in the subsequent three answers ..."

(My text is just a rough sketch, - you need to edit it.)

I believe these changes would (1) help those users who do read FAQ, and (2) would help other forum members (like mikeone, Paris Geek and myself) and yourself to help those who write in this forum, - by just referring to the existing answer, thus avoiding the need to formulate it every time again.

Thanks for your consideration.

Kostya Vasilyev

  • Hero Member
  • *****
  • Posts: 12740
Re: FAQ: proposed additions and changes
« Reply #1 on: September 17, 2016, 01:45:00 am »
Made a few edits in both sections, please take a look.

http://www.aqua-mail.com/?page_id=227
Creating debug logs for diagnostics: https://www.aqua-mail.com/troubleshooting/

The official FAQ: https://www.aqua-mail.com/faq/

Лог-файлы для диагностики: https://www.aqua-mail.com/ru/troubleshooting/

Вопросы и ответы: https://www.aqua-mail.com/ru/faq/

StR

  • Hero Member
  • *****
  • Posts: 1558
Re: FAQ: proposed additions and changes
« Reply #2 on: September 17, 2016, 03:50:32 am »
Kostya, I am sorry, maybe I am not looking right, but I am not seeing any changes. Did you forget to save the edits, or something?

mikeone

  • Hero Member
  • *****
  • Posts: 2762
Re: FAQ: proposed additions and changes
« Reply #3 on: September 17, 2016, 02:27:18 pm »
Kostya, I am sorry, maybe I am not looking right, but I am not seeing any changes. Did you forget to save the edits, or something?
In the meantime the FAQ is updated.

StR

  • Hero Member
  • *****
  • Posts: 1558
Re: FAQ: proposed additions and changes
« Reply #4 on: September 18, 2016, 04:28:03 am »
Yep, it is updated. Thank you, Kostya!

If I may, - a few minor suggestions:
1. Move one of the sentences from almost the end to the second position, as indicated below.
(So, that new users are not spooked. :-)  )
2. "long press <something>"
I am not 100% sure, but I'd say "long press on <something>". You have 3 occurrences of that.

Second part:
3. Start with the most general part (applicable to a broader user base), then more specific (MIUI, Huawei). I would even consider swapping Doze Mode and {MIUI/Huawei}.
(BTW, am I mixing something up, or did Samsung had something optimization as well?)

4. The Question (header) does not need to contain very narrow qualifier (MIUI, Huawei).
If you insist on keeping  it there, put in parentheses, e.g. like this:
Persistent network errors or the app not checking mail (multiple culprits, including MIUI, Huawei)
Otherwise, if I don't have MIUI or Huawei, I would just skip expanding this item.

I hope this helps.


Quote
Push must be enabled (configured) in 3 places: (1) for the entire app, (2) for the specific account, and (3) for the specific folder(s).

Given the app’s default settings, usually only step (2) is necessary. Just one step to enable push mail for an account.

(1) For the entire app:

This is enabled by default, but please see app settings -> mail, receiving.

(2) For the account:

This is off by default.

Long press on the account in the main window (account list) and choose “Options and Folders”, then “Account options” and you’ll see it.

(3) For the folder(s):

This is enabled by default for the main Inbox folder, but is disabled for other folders.

Long press on the account in the main window (account list) and choose “Options and Folders”, then “Folders”.

Find the Inbox (or whatever other folder), tap the folder name and set it “to sync”, then tap the gears (settings) icon on the right or long press on the folder name.

You’ll see a popup window with options specific to this folder, including push mail.

Given the app’s default settings, usually only step (2) is necessary. Just one step to enable push mail for an account.

In addition, there is an application-level setting to restrict push mail to WiFi (e.g. use IMAP Push over WiFi when at home or at work, but avoid wasting mobile traffic and battery power while en route).


Quote
Persistent network errors or the app not checking mail, MIUI, Huawei, others

In general, if the app is not checking mail (the default is once every 15 minutes), the the most common culprits are:

– Memory optimizer apps and battery optimizer apps

– Sometimes those are third party apps, sometimes built into the phone’s system software (Xiaomi, Huawei, possibly others)

– For Android 6.0 and newer, Doze mode






There have been several reports recently specific to MIUI:

– Apparently MIUI has some sort of “battery optimizer” thing built-in

– Which prevents apps from accessing the network when in the background

– This is in the phone’s system Settings app -> Additional Settings -> Battery & Performance -> Manage apps battery usage

Several users who were having this exact issue, and found and turned this “battery optimizer” off (which then resolved the issues seen in AquaMail) — swore that they’ve never before seen this setting or knew where it was.

My theory is that MIUI recently started enabling it automatically, without telling anyone (the device owners).

And then I’m sure they’ve whitelisted Gmail and a few other apps. Apparently not AquaMail though.



Even if your phone is not a Xiaomi with MIUI, if you get “persistent network errors” or the app isn’t checking mail, it could be caused by same type of “battery optimizer” (an app or something built-in) which blocks the app’s access to the network when it’s in the background.

In particular, recent Huawei phones have a kind of “battery optimizer” too.

On my Honor 5C, it’s in the phone’s Settings app -> Advanced settings -> Battery manager -> Protected apps -> and you will want to set AquaMail to “Protected” here.



Android 6 and newer and its “Doze Mode”

Doze Mode is where Android will not let apps run in the background as often as they need to while the phone is stationary.

This kicks in after a few hours on Android 6 and sooner on Android 7.

The app will prompt you to “whitelist” (exclude) it from this “Doze Mode” within a day after installing if it detects Android 6 or newer.

To check, please bring up AquaMail settings -> mail, receiving. If the app is not already whitelisted, there will be a panel / button / message / prompt asking you to do this, as one of the settings items (but in bold font).




In general, if the app is not checking mail (the default is once every 15 minutes), the the most common culprits are:

– Memory optimizer apps and battery optimizer apps

– Sometimes those are third party apps, sometimes built into the phone’s system software (Xiaomi, Huawei, possibly others)

– For Android 6.0 and newer, Doze mode

Kostya Vasilyev

  • Hero Member
  • *****
  • Posts: 12740
Re: FAQ: proposed additions and changes
« Reply #5 on: September 20, 2016, 09:00:53 pm »
Thank you. Fixed "long press *on*", reordered / edited under push and battery.
Creating debug logs for diagnostics: https://www.aqua-mail.com/troubleshooting/

The official FAQ: https://www.aqua-mail.com/faq/

Лог-файлы для диагностики: https://www.aqua-mail.com/ru/troubleshooting/

Вопросы и ответы: https://www.aqua-mail.com/ru/faq/

peace3314

  • Newbie
  • *
  • Posts: 1
Re: FAQ: proposed additions and changes
« Reply #6 on: September 21, 2016, 04:13:21 am »
I just started using your app.

The exchange push in the developmental version seems quick.

Is there a way to set a different notification tone for each account?

StR

  • Hero Member
  • *****
  • Posts: 1558
Re: FAQ: proposed additions and changes
« Reply #7 on: September 21, 2016, 04:56:55 am »
Thank you. Fixed "long press *on*", reordered / edited under push and battery.
👍

StR

  • Hero Member
  • *****
  • Posts: 1558
Re: FAQ: proposed additions and changes
« Reply #8 on: September 21, 2016, 05:03:41 am »
I just started using your app.

The exchange push in the developmental version seems quick.

Is there a way to set a different notification tone for each account?

I am not using Exchange, but I assume the notification tone settings work the same way as for IMAP accounts: Long press on the account in the account list view.
-> Special Settings->  Message notifications (turn it on) and -> Sound -- choose the sound you want, as well as LED color, if you wish.


PS. You question here is in a thread with a very different topic.
It would've been better to ask such question in a separate thread, so it wouldn't be missed.

Kostya Vasilyev

  • Hero Member
  • *****
  • Posts: 12740
Re: FAQ: proposed additions and changes
« Reply #9 on: September 23, 2016, 09:09:21 pm »
Quote
I am not using Exchange, but I assume the notification tone settings work the same way as for IMAP accounts: Long press on the account in the account list view.
-> Special Settings->  Message notifications (turn it on) and -> Sound -- choose the sound you want, as well as LED color, if you wish.

Yes, standard procedure for all account types.

PS - glad to hear that EWS push is working!
Creating debug logs for diagnostics: https://www.aqua-mail.com/troubleshooting/

The official FAQ: https://www.aqua-mail.com/faq/

Лог-файлы для диагностики: https://www.aqua-mail.com/ru/troubleshooting/

Вопросы и ответы: https://www.aqua-mail.com/ru/faq/