-
Notifications
You must be signed in to change notification settings - Fork 2
/
mobile-app.md
172 lines (133 loc) · 5.51 KB
/
mobile-app.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
## Mobile app (Flutter)
<a href="./mobile-app.md">
<img alt="Translation" src="https://img.shields.io/badge/Bahasa_Indonesia-blue?style=for-the-badge&logo=googletranslate&logoColor=blue&labelColor=white">
</a>
<a href="./mobile-app.en.md">
<img alt="Translation" src="https://img.shields.io/badge/English-blue?style=for-the-badge&logo=googletranslate&logoColor=blue&labelColor=white">
</a>
<a href="./mobile-app.zh-CN.md">
<img alt="Translation" src="https://img.shields.io/badge/简体中文-blue?style=for-the-badge&logo=googletranslate&logoColor=blue&labelColor=white">
</a>
<a href="./mobile-app.ja.md">
<img alt="Translation" src="https://img.shields.io/badge/日本語-blue?style=for-the-badge&logo=googletranslate&logoColor=blue&labelColor=white">
</a>
<a href="./mobile-app.ar.md">
<img alt="Translation" src="https://img.shields.io/badge/Arabic_عربي-blue?style=for-the-badge&logo=googletranslate&logoColor=blue&labelColor=white">
</a>
<a href="./mobile-app.pt.md">
<img alt="Translation" src="https://img.shields.io/badge/Português-blue?style=for-the-badge&logo=googletranslate&logoColor=blue&labelColor=white">
</a>
<a href="./mobile-app.es.md">
<img alt="Translation" src="https://img.shields.io/badge/Español-blue?style=for-the-badge&logo=googletranslate&logoColor=blue&labelColor=white">
</a>
<a href="./mobile-app.fr.md">
<img alt="Translation" src="https://img.shields.io/badge/Français-blue?style=for-the-badge&logo=googletranslate&logoColor=blue&labelColor=white">
</a>
<a href="./mobile-app.vi.md">
<img alt="Translation" src="https://img.shields.io/badge/Tiếng_Việt-blue?style=for-the-badge&logo=googletranslate&logoColor=blue&labelColor=white">
</a>
<a href="./mobile-app.hi.md">
<img alt="Translation" src="https://img.shields.io/badge/Hindi_हिंदी-blue?style=for-the-badge&logo=googletranslate&logoColor=blue&labelColor=white">
</a>
### Persyaratan Sistem
Pastikan sistem Anda memenuhi persyaratan berikut sebelum memulai instalasi:
- Flutter SDK v3.16 or higher
### Langkah-langkah Instalasi
1. Clone/extract Repository
2. Install dependencies:
```bash
flutter pub get
```
3. Jalankan `build_runner` untuk men-generate file `*.g.dart`
```bash
dart run build_runner build
```
#### Setup environment
1. Rename `.env.example` to `.env`
2. Sesuaikan `API_BASE_URL` di file `.env`
#### Midtrans client key
- Selesaikan langkah sebelumnya di [Back-end service - Setup midtrans server & client key](api-service.md#setup-midtrans-server--client-key)
- Salin **client key** ke file `.env`
```sh
# for debug / sandbox
MIDTRANS_CLIENT_KEY_SANDBOX=SB-Mid-client-xxxx
# for release / production
MIDTRANS_CLIENT_KEY=Mid-client-xxxx
```
#### Setup **Google sign in** client ID
- Selesaikan langkah sebelumnya di [Back-end service - Setup Google sign in server & client ID](api-service.md#setup-google-sign-in-server--client-id)
- Salin `Web Client ID` dan `Server Client ID` ke file `.env`
```sh
# frontend google signin / web client id
GOOGLE_CLIENT_ID=xxxx.apps.googleusercontent.com
# backend / server client id
GOOGLE_SERVER_CLIENT_ID=xxxx.apps.googleusercontent.com
```
- Salin `Web Client ID` ke `android/app/src/main/res/values/strings.xml`
```xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="default_web_client_id">YOUR_CLIENT_ID</string>
</resources>
```
- **Android** client ID
- Buka terminal, arahkan ke direktori project aplikasi
- Lalu arahkan ke folder android
```bash
cd <path-to-project>
cd android
```
- Jalankan perintah berikut
- Untuk linux dan macos
```bash
keytool -genkey -v -keystore <path-to-project>/android/app/androidkey.jks -keyalg RSA -keysize 2048 -validity 10000 -alias keyalias
```
- Untuk windows
```powershell
keytool -genkey -v -keystore <path-to-project>/android/app/androidkey.jks ^
-storetype JKS -keyalg RSA -keysize 2048 -validity 10000 ^
-alias upload
```
- :warning: Ganti `<path-to-project>` dengan path direktori projek aplikasi.
Contoh:
```bash
# linux
~/ngoding/PROJECTS/backtix/backtix_app/android/app/androidkey.jks
# windows
D:/ngoding/flutter/backtix-app/android/app/androidkey.jks
```
- Anda akan diminta memasukkan password, contoh `backtix`
- Buka file `android/app/build.gradle` lalu ubah bagian ini:
```gradle
signingConfigs {
debug {
keyAlias 'keyalias'
keyPassword <your-password> // sesuaikan dengan password dari langkah sebelumnya
storeFile file('androidkey.jks')
storePassword <your-password> // sesuaikan dengan password dari langkah sebelumnya
}
}
```
- Buka terminal, arahkan ke folder `android`
di project aplikasi, lalu jalankan perintah berikut:
```bash
./gradlew signingReport
```
- Cari dan salin nilai `SHA1` dari `variant: debug` paling atas.
- Pergi ke [Google Cloud Console](https://console.cloud.google.com)
- Pilih `Credentials` di sidebar kiri, klik `CREATE CREDENTIALS`, pilih `OAuth client ID`
- Pilih `Android` application type
- Beri nama, dan `Package name`. package name dapat diketahui dari file `android/app/build.gradle`
```gradle
android {
namespace "com.example.backtix_app"
compileSdkVersion 34
ndkVersion flutter.ndkVersion
...
}
```
- Jika ingin mengubah package name bisa menggunakan [change_app_package_name](https://pub.dev/packages/change_app_package_name)
- Masukkan `SHA1` dari langkah sebelumnya, lalu save/create