更新安装文档，支持Android推送

api/app/Http/Controllers/PushDeerDeviceController.php

@@ -35,7 +35,7 @@ class PushDeerDeviceController extends Controller
         }
 
         $type = 'ios';
-        if (strlen($validated['type']) > 0) {
+        if (isset($validated['type']) && strlen($validated['type']) > 0) {
             $type = trim($validated['type']);
         }
 

doc/安装文档.md

@@ -2,7 +2,8 @@
 # PushDeer 安装文档
 
   - ⚠️ 当前PushDeer依然在开发中，API和安装文档均有可能调整。
-  - ⚠️ 当前安装文档仅 iOS 版可用
+  - ⚠️ 当前安装文档支持 iOS、Mac和Android版
+  - ⚠️ 当前MiPush直接调用官方接口，未使用异步队列，可能存在性能瓶颈
 
 ## API服务器的安装
 
@@ -75,12 +76,48 @@ services:
 </VirtualHost>
 ```
 
-### STEP3：配置推送证书
+### STEP3：配置推送信息
+
+#### iOS 推送
 
 进入 push 目录，修改 `*.yml.sample` 为 `*.yml`。其中iOS应用和Clip使用两个分开的证书进行推送，`ios.yml` 是APP的配置、`clip.yml` 是Clip的配置。注意根据开发和产品状态，修改`yml`中的值`production`。
 
 默认配置中，`c.p12` 是APP的推送证书、`cc.p12`是Clip的推送证书。
 
+#### Android 推送（ 采用MiPush实现 ）
+
+1. [注册小米开发者，并创建应用](https://dev.mi.com/console/appservice/push.html)(需要企业资质)，获得`包名`（形如com.pushdeer.app）和`AppSecret`(形如RWQf344dF==)
+1. 在`docker-compose.yml`中通过环境变量添加包名和AppSecret。
+
+```yml
+version: '2'
+services:
+  redis: 
+    image: 'bitnami/redis:6.0.16'
+    environment:
+      - ALLOW_EMPTY_PASSWORD=yes
+  app:
+    #image: 'webdevops/php-apache:8.0-alpine'
+    build: './docker/web/'
+    ports:
+      - '80:80'
+      - '443:443' # 开放 https 需要的接口
+    depends_on:
+      - redis
+    volumes:
+      - './:/app'
+    environment:
+      - DB_DATABASE=pushdeer
+      - DB_HOST=clouddb.com
+      - DB_PASSWORD=thep@ssw0rd
+      - DB_PORT=3306
+      - DB_TIMEZONE=+08:00
+      - DB_USERNAME=pushdeer
+      - APP_DEBUG=false
+      - ANDROID_PACKAGE="这里填写包名"
+      - MIPUSH_SECRET="这里填写小米推送应用的AppSecret"
+```
+
 ### STEP4：构建并运行镜像
 
 运行 `docker-compose up -d --build`，启动API。访问 `https://yourdomain.com` 即可查看到API服务器默认网页。
@@ -93,10 +130,14 @@ services:
 
 修改以下内容：
 
-1. 更换项目中的名称和标识（ 请勿直接使用PushDeer的名称和标识 ）
+1. 更换项目中的名称和标识（ 如要上架商店，请勿直接使用PushDeer的名称和标识 ）
 1. 将项目中的 Bundle Identifier （ xcode.proj文件、General标签 ）改为和通知证书响应的
 1. 将项目中的 签名和team更换为用于上架的开发者的（xcode.proj文件、Signing & Capabilities标签）
 1. 修改[API接口中的域名](https://github.com/easychen/pushdeer/blob/10e4d3bb62d8d66d4739598a8f4af32eda4cceef/ios/PushDeer-iOS/PushDeer/Service/PushDeerApi.swift#L37)，替换为之前安装的服务
 
+## Android客户端的编译
+
+1. 修改包名为上边小米推送应用中设置，不然推送时会返回`bad target`提示
+