**Cocoapods**
```bash
# Descomenta la siguiente línea para definir una plataforma global para tu proyecto
# platform :ios, '13.0'
target 'MyApp' do
# Comenta la siguiente línea si no quieres usar frameworks dinámicos
use_frameworks!
pod 'PushwooshXCFramework'
pod 'PushwooshFramework/PushwooshForegroundPush'
end
```
### 3. Añadir la configuración de `PushwooshForegroundPush` en AppDelegate
```swift
import UIKit
import PushwooshFramework
import PushwooshForegroundPush
@main
class AppDelegate: UIResponder, UIApplicationDelegate, PWMessagingDelegate, PWForegroundPushDelegate {
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
Pushwoosh.ForegroundPush.foregroundNotificationWith(style: .style1,
duration: 5,
vibration: .notification,
disappearedPushAnimation: .balls)
Pushwoosh.ForegroundPush.delegate = self
return true
}
func pushwoosh(_ pushwoosh: Pushwoosh, onMessageReceived message: PWMessage) {
if let payload = message.payload {
// Método de Pushwoosh
Pushwoosh.ForegroundPush.showForegroundPush(userInfo: payload)
}
}
}
```
Usando el método `foregroundNotificationWith`
El método `foregroundNotificationWith` te permite mostrar una notificación push personalizada en primer plano con estilo, duración y retroalimentación háptica configurables.
Firma del método (Swift / Objective-C):
```swift
@objc
static func foregroundNotificationWith(
style: PWForegroundPushStyle,
duration: Int,
vibration: PWForegroundPushHapticFeedback,
disappearedPushAnimation: PWForegroundPushDisappearedAnimation
)
```
`Parámetros:`
1. `style` (`PWForegroundPushStyle`)
* Actualmente, solo `style1` está disponible.
2. `duration` (`Int`)
* Especifica cuánto tiempo se mostrará la notificación antes de desaparecer (en segundos).
3. `vibration` (`PWForegroundPushHapticFeedback`)
* Controla la retroalimentación háptica cuando se muestra la notificación. Opciones disponibles:
```swift
case none // Sin vibración
case light // Vibración ligera
case medium // Vibración media
case heavy // Vibración fuerte
case soft // Vibración suave
case rigid // Vibración rígida
case notification // Vibración de notificación estándar
```
4. `disappearedPushAnimation` (`PWForegroundPushDisappearedAnimation`)
* Animación de desaparición de la notificación push
```swift
case balls = 0
case regularPush
```
### 4. Implementando el método delegado `didTapForegroundPush`
Para manejar los toques del usuario en las notificaciones push personalizadas en primer plano, implementa el método del protocolo `PWForegroundPushDelegate`:
```swift
// Manejar el toque en la notificación push en primer plano
func didTapForegroundPush(_ userInfo: [AnyHashable : Any]) {
print("Foreground custom push: \(userInfo)")
// Realizar cualquier acción, por ejemplo, navegar a una pantalla específica
// navigateToScreen(for: userInfo)
}
```
Notas:
* Este método se llama cuando el usuario toca una notificación push personalizada en primer plano.
* `userInfo` contiene el payload de la notificación.
* Asegúrate de establecer `Pushwoosh.ForegroundPush.delegate = self` después de la configuración.
### 5. Parámetros opcionales para personalizar las notificaciones push en primer plano
El módulo `PushwooshForegroundPush` proporciona varios parámetros opcionales para personalizar la apariencia y el comportamiento de tus notificaciones push en primer plano. Estos se pueden establecer globalmente a través de propiedades estáticas.
| Propiedad | Tipo | Descripción | Predeterminado |
|---|---|---|---|
| useLiquidView | Bool | Usa la vista Liquid Glass en iOS 26. | false |
| gradientColors | [UIColor]? | Array opcional de colores para un fondo degradado. | nil |
| backgroundColor | UIColor? | Color de fondo para la notificación push. Si es nil y gradientColors no está establecido, se utiliza el degradado predeterminado. | Degradado del sistema predeterminado |
| usePushAnimation | Bool | Indica si se debe animar la notificación push cuando se muestra. | true |
| titlePushColor | UIColor? | Color del texto del título de la notificación. Por defecto, es el blanco del sistema si es nil. | blanco |
| messagePushColor | UIColor? | Color del texto del mensaje de la notificación. Por defecto, es el blanco del sistema si es nil. | blanco |
| titlePushFont | UIFont? | Fuente del texto del título de la notificación. Por defecto, es la fuente del sistema si es nil. | Fuente del sistema predeterminada |
| messagePushFont | UIFont? | Fuente del texto del mensaje de la notificación. Por defecto, es la fuente del sistema si es nil. | Fuente del sistema predeterminada |