Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 12 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,14 +10,22 @@ as usual.
is described in [BUILD.md](BUILD.md).

## Install
1. On your Android phone (Android 10 or later), open **https://github.com/asulwer/CallGuard/releases**.
<a href="https://play.google.com/store/apps/details?id=com.acclscompany.callguard"><img alt="Get it on Google Play" src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" height="80"></a>

Install Call Guard from **[Google Play](https://play.google.com/store/apps/details?id=com.acclscompany.callguard)** (Android 10 or later). Play keeps it up to date.

**Or install the `.apk` directly:**
1. On your phone, open **https://github.com/asulwer/CallGuard/releases**.
2. Download the `.apk` from the latest release and open it.
3. When Android asks, allow your browser or Files app to install apps. Google Play Protect may warn about
an app from an unknown developer; choose **Install anyway**.

**Updating:** install the newer `.apk` the same way, over the old one. Your patterns and call log are kept.
Afterwards you can switch "install unknown apps" off again under Settings → Apps → Special app access →
**Install unknown apps**.
**Updating the `.apk`:** install the newer `.apk` the same way, over the old one. Your patterns and call
log are kept. Afterwards you can switch "install unknown apps" off again under Settings → Apps → Special
app access → **Install unknown apps**.

The Google Play version and the `.apk` are the same app, signed with the same key, so either can update
the other — no need to uninstall to switch.

## First-time setup
Open Call Guard. The **Home** tab shows what still needs doing:
Expand Down
3 changes: 2 additions & 1 deletion docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,8 @@ description: "Call Guard blocks unwanted calls on Android by area code, country
Block unwanted calls by area code, country or region — the people in your contacts always get through.
{: .fs-6 .fw-300 }

[Download the latest version](https://github.com/asulwer/CallGuard/releases/latest){: .btn .btn-primary .fs-5 .mb-4 .mb-md-0 .mr-2 }
[Get it on Google Play](https://play.google.com/store/apps/details?id=com.acclscompany.callguard){: .btn .btn-primary .fs-5 .mb-4 .mb-md-0 .mr-2 }
[Download the .apk](https://github.com/asulwer/CallGuard/releases/latest){: .btn .fs-5 .mb-4 .mb-md-0 .mr-2 }
[Get started](install.html){: .btn .fs-5 .mb-4 .mb-md-0 }

---
Expand Down
27 changes: 22 additions & 5 deletions docs/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ nav_order: 2
# Install
{: .no_toc }

Call Guard isn't in the Google Play Store. You install it directly from its
Get Call Guard from [Google Play](https://play.google.com/store/apps/details?id=com.acclscompany.callguard), or install the `.apk` directly from its
[GitHub releases](https://github.com/asulwer/CallGuard/releases).
{: .fs-6 .fw-300 }

Expand All @@ -16,10 +16,22 @@ Call Guard isn't in the Google Play Store. You install it directly from its

---

## Install
## Install from Google Play

You need an Android phone with **Android 10 or later**.

<a href="https://play.google.com/store/apps/details?id=com.acclscompany.callguard"><img alt="Get it on Google Play" src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" height="80"></a>

Open **[Call Guard on Google Play](https://play.google.com/store/apps/details?id=com.acclscompany.callguard)** on your phone and tap **Install**. Play installs updates
automatically.

Then [set Call Guard up](setup.html) — it does nothing until you do.

## Install the .apk instead
{: #install-the-apk-instead }

If you'd rather not use Google Play, install the same app directly from GitHub:

1. On the phone, open **[the latest release](https://github.com/asulwer/CallGuard/releases/latest)**.
2. Under **Assets**, tap the file named `CallGuard-<version>.apk` to download it.
3. Open the download — from the browser's download notification, or from the **Files** app's
Expand All @@ -44,12 +56,17 @@ The version is shown at the bottom of Call Guard's **Home** tab, for example `Ca

## Update

Install the newer `.apk` the same way, over the old one — no need to uninstall first. Your patterns,
their on/off state and the call log are kept, and Call Guard stays set up.
- **From Google Play:** updates install automatically, or tap **Update** on Call Guard's Play page.
- **The .apk:** install the newer `.apk` the same way, over the old one — no need to uninstall first.

Either way your patterns, their on/off state and the call log are kept, and Call Guard stays set up.

The Google Play version and the `.apk` are the same app signed with the same key, so you can switch
between them at any time by installing one over the other.

{: .warning }
If Android says **App not installed** when updating, the new file was signed with a different key than
the copy on your phone (for example, a copy you built yourself). Export your patterns
the copy on your phone — for example, a copy you built yourself. Export your patterns
([Backup](using.html#backup)), uninstall the old copy, install the new one and import your patterns again.

## Uninstall
Expand Down