Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add Japanese README #253

Merged
merged 1 commit into from
Jul 10, 2024
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
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
简体中文 | [English](README_EN.md)
简体中文 | [English](README_EN.md) | [日本語](README_JP.md)

# 雹 Hail

Expand Down
2 changes: 1 addition & 1 deletion README_EN.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
[简体中文](README.md) | English
[简体中文](README.md) | English | [日本語](README_JP.md)

**English is not my native language. Help us translate README**

Expand Down
235 changes: 235 additions & 0 deletions README_JP.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,235 @@
# 雹 Hail

[![Android CI status](https://github.com/aistra0528/Hail/workflows/Android%20CI/badge.svg)](https://github.com/aistra0528/Hail/actions)
[![翻訳状態](https://hosted.weblate.org/widgets/hail/-/svg-badge.svg)](https://hosted.weblate.org/engage/hail/)
[![Downloads](https://img.shields.io/github/downloads/aistra0528/Hail/total.svg)](https://github.com/aistra0528/Hail/releases)
[![License](https://img.shields.io/github/license/aistra0528/Hail)](LICENSE)

雹は、Androidアプリを凍結するための自由ソフトウェアです。[GitHub Releases](https://github.com/aistra0528/Hail/releases)

[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" alt="Get it on F-Droid" height="80">](https://f-droid.org/packages/com.aistra.hail/)

<img src="fastlane/metadata/android/zh-CN/images/phoneScreenshots/1.png" width="32%" /> <img src="fastlane/metadata/android/zh-CN/images/phoneScreenshots/2.png" width="32%" /> <img src="fastlane/metadata/android/zh-CN/images/phoneScreenshots/3.png" width="32%" />

## 凍結

凍結`freeze`は、**アプリが不要なときに即座に停止する**(オンデマンドリクエスト)動作を指す言葉で、デバイスの使用をより良くし、RAMの使用量を削減し、電力を節約します。ユーザーは、アプリを解凍`unfreeze`して元の状態に戻すこともできます。

一般的に、「凍結」は無効化を意味しますが、雹はアプリを隠したり、一時停止したりすることもできます。

### 無効化

無効化されたアプリは、ランチャーに表示されず、インストール済みアプリのリストには「無効」と表示されます。アプリを有効化`enable`して元に戻します。

### 隠す

隠されたアプリは、ランチャーやインストール済みアプリのリストに表示されません。アプリを表示`unhide`して元に戻します。

> この状態では、アプリはほぼアンインストールされた状態になりますが、アプリのデータや実際のパッケージファイルはデバイスから削除されません。

### 一時停止 (Android 7.0+)

一時停止されたアプリは、デバイスのランチャーでアイコンがグレースケールで表示されます。アプリを再開`unsuspend`して元に戻します。

> この状態では、アプリの通知は非表示になり、開始されたアクティビティは停止され、トースト、ダイアログ、オーディオの再生もできません。ユーザーが一時停止されたアプリを起動しようとすると、システムは代わりにユーザーに対してこのアプリを使用できないことを通知するダイアログを表示します。

一時停止は、ユーザーがアプリと対話するのを防ぐだけで、アプリがバックグラウンドで実行されるのを防ぐことは**ありません**。

## 作業モード

雹は、`デバイス所有者`、`Dhizuku`、`Root`、および`Shizuku`(Suiを含む)で動作できます。

**雹で凍結されたアプリは、同じ作業モードで解凍する必要があります。**

1. ワイヤレスデバッグをサポートするデバイス(Android 11+)またはroot化されたデバイスの場合、`Shizuku`を推奨します。

2. root化されたデバイスの場合、`Root`が代替手段です。**速度が遅いです。**

3. それ以外の場合は、`デバイス所有者`または`Dhizuku`を選択します。**設定が面倒です。**

### デバイス所有者 - 隠す / 一時停止

このモードでは、次のメソッドを呼び出します:

- `DevicePolicyManager.setApplicationHidden`を使用してアプリを隠します。

- `DevicePolicyManager.setPackagesSuspended`を使用してアプリを一時停止します。

**アンインストールする前にデバイス所有者を削除する必要があります**

#### adbでデバイス所有者を設定する

[Android デバッグブリッジ (adb) ガイド](https://developer.android.google.cn/studio/command-line/adb)

[Android SDK プラットフォームツールのダウンロード](https://developer.android.google.cn/studio/releases/platform-tools)

adbコマンドを発行します:

```shell
adb shell dpm set-device-owner com.aistra.hail/.receiver.DeviceAdminReceiver
```

デバイス所有者が正常に設定された場合、adbは次のメッセージを出力します:

```
Success: Device owner set to package com.aistra.hail
Active admin set to component {com.aistra.hail/com.aistra.hail.receiver.DeviceAdminReceiver}
```

それ以外の場合は、検索エンジンでメッセージを検索してください。

#### デバイス所有者を削除する

設定 > デバイス所有者を削除

### [Dhizuku](https://github.com/iamr0s/Dhizuku) - 隠す / 一時停止

このモードでは、次のメソッドを呼び出します:

- `DevicePolicyManager.setApplicationHidden`を使用してアプリを隠します。

- `DevicePolicyManager.setPackagesSuspended`を使用してアプリを一時停止します。

### Root - 無効化 / 隠す / 一時停止

このモードでは、次のコマンドを実行します:

- `am force-stop`を使用してアプリを強制停止します。
- `pm disable`を使用してアプリを無効化します。
- `pm hide`を使用してアプリを隠します。
- `pm suspend`を使用してアプリを一時停止します。

### [Shizuku](https://github.com/RikkaApps/Shizuku) - 無効化 / 隠す / 一時停止

このモードでは、非SDKインターフェースを呼び出します:

- `IActivityManager.forceStopPackage`を使用してアプリを強制停止します。
- `IPackageManager.setApplicationEnabledSetting`を使用してアプリを無効化します。
- `IPackageManager.setApplicationHiddenSettingAsUser`を使用してアプリを隠します。(rootが必要)
- `IPackageManager.setPackagesSuspendedAsUser`を使用してアプリを一時停止します。

### 特権システムアプリ - 無効化

このモードでは、次のAPIを呼び出します:

- `ActivityManager.forceStopPackage`を使用してアプリを強制停止します。
- `PackageManager.setApplicationEnabledSetting`を使用してアプリを無効化します。

次の特権アプリの権限が必要です:

```xml
<?xml version="1.0" encoding="utf-8"?>
<permissions>
<privapp-permissions package="com.aistra.hail">
<permission name="android.permission.PACKAGE_USAGE_STATS"/>
<permission name="android.permission.FORCE_STOP_PACKAGES"/>
<permission name="android.permission.CHANGE_COMPONENT_ENABLED_STATE"/>
</privapp-permissions>
</permissions>
```

このモードを使用するには、雹を特権システムアプリとしてインストールする必要があります。

推奨される方法は、ROMをビルドする際に雹をインポートすることです。`Android.bp`の例:

```bp
android_app_import {
name: "Hail",
apk: "Hail.apk",
privileged: true,

dex_preopt: {
enabled: false,
},
presigned: true,
preprocessed: true,

required: ["privapp-permissions_com.aistra.hail.xml"]
}

prebuilt_etc {
name: "privapp-permissions_com.aistra.hail.xml",
src: "privapp-permissions.xml",
sub_dir: "permissions",
}
```

## 復元

### adbで

com.package.nameをターゲットアプリのパッケージ名に置き換えます。

```shell
# アプリを有効化
adb shell pm enable com.package.name
# アプリの非表示を解除(rootが必要)
adb shell su -c pm unhide com.package.name
# アプリの一時停止を解除
adb shell pm unsuspend com.package.name
```

### ファイルを変更する

`/data/system/users/0/package-restrictions.xml`にアクセスします。このファイルにはアプリの制限に関する情報が保存されています。これを変更、名前変更、または削除できます。

- アプリを有効化:`enabled`の値を2(DISABLED)または3(DISABLED_USER)から1(ENABLED)に変更します。

- アプリの非表示を解除:`hidden`の値をtrueからfalseに変更します。

- アプリの一時停止を解除:`suspended`の値をtrueからfalseに変更します。

### リカバリーモードでデータを消去する

**私の責任ではありません :(**

## API

```shell
adb shell am start -a action -e name value
```

`action`は次の定数のいずれかです:

- `com.aistra.hail.action.LAUNCH`:ターゲットアプリを解凍して起動します。解凍されている場合は、直接起動します。`name="package"` `value="com.package.name"`

- `com.aistra.hail.action.FREEZE`:ターゲットアプリを凍結します。ホームにチェックされている必要があります。`name="package"` `value="com.package.name"`

- `com.aistra.hail.action.UNFREEZE`:ターゲットアプリを解凍します。`name="package"` `value="com.package.name"`

- `com.aistra.hail.action.FREEZE_TAG`:ターゲットタグ内のすべての非ホワイトリストアプリを凍結します。`name="tag"` `value="タグ名"`

- `com.aistra.hail.action.UNFREEZE_TAG`:ターゲットタグ内のすべてのアプリを解凍します。`name="tag"` `value="タグ名"`

- `com.aistra.hail.action.FREEZE_ALL`:ホームのすべてのアプリを凍結します。`extra`は必要ありません。

- `com.aistra.hail.action.UNFREEZE_ALL`:ホームのすべてのアプリを解凍します。`extra`は必要ありません。

- `com.aistra.hail.action.FREEZE_NON_WHITELISTED`:ホームのすべての非ホワイトリストアプリを凍結します。`extra`は必要ありません。

- `com.aistra.hail.action.FREEZE_AUTO`:ホームのアプリを自動的に凍結します。`extra`は必要ありません。

- `com.aistra.hail.action.LOCK`:画面をロックします。`extra`は必要ありません。

- `com.aistra.hail.action.LOCK_FREEZE`:ホームのすべてのアプリを凍結し、画面をロックします。`extra`は必要ありません。

## 翻訳を手伝う

雹をあなたの言語に翻訳するか、既存の翻訳を改善するには、[Weblate](https://hosted.weblate.org/engage/hail/)を使用してください。

[![翻訳状態](https://hosted.weblate.org/widgets/hail/-/multi-auto.svg)](https://hosted.weblate.org/engage/hail/)

## ライセンス

Hail - Freeze Android apps
Copyright (C) 2021-2024 Aistra
Copyright (C) 2022-2024 Hail contributors

このプログラムはフリーソフトウェアです。あなたはこれを再配布および/または修正することができます。
フリーソフトウェア財団によって発行されたGNU一般公衆利用許諾契約書のバージョン3、または(あなたの選択により)それ以降のバージョンに従います。

このプログラムは有用であることを期待して配布されていますが、いかなる保証もありません。
商品性や特定の目的への適合性の保証も含まれません。詳細については、GNU一般公衆利用許諾契約書を参照してください。

あなたはこのプログラムと共にGNU一般公衆利用許諾契約書のコピーを受け取ったはずです。
受け取っていない場合は、<https://www.gnu.org/licenses/>を参照してください。