Installation Guide

🚀 Quick Installation

This plugin is designed to be extremely easy to integrate. You don’t need to modify any configuration files.

For iOS:

1. Add dependency in pubspec.yaml:

dependencies:
  lazarillo_maps: ^0.0.50

2. Install:

flutter pub get
cd ios
pod install

3. Done! The plugin configures itself automatically.

For Android:

1. Add dependency in pubspec.yaml:

dependencies:
  lazarillo_maps:
    hosted: https://dart.cloudsmith.io/lazarillo-app/lazarillo_maps/
    version: 0.0.50

2. Install:

flutter pub get

3. Done! No additional configurations required.

🔧 Automatic Configuration

The plugin includes automatic configurations that:

iOS:

• ✅ Handles static dependencies automatically
• ✅ Configures CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES
• ✅ Sets DEFINES_MODULE = YES
• ✅ Configures BUILD_LIBRARY_FOR_DISTRIBUTION = YES
• ✅ No Podfile modifications required

Android:

• ✅ Automatically configures SDK dependencies
• ✅ Handles permissions automatically
• ✅ No build.gradle modifications required

⚠️ Important Note About iOS Installation

Static Dependencies Warning

When installing pods for iOS, you will see this warning:

[!] The 'Pods-Runner' target has transitive dependencies that include statically linked binaries: (LZSDKMaps)

This warning is NORMAL and EXPECTED. It appears because LZSDKMaps includes static libraries, which is standard for this type of SDK. This warning:

• ✅ Does NOT affect functionality
• ✅ Does NOT cause compilation errors
• ✅ Is handled automatically by the plugin
• ✅ Can be safely ignored

The plugin is configured to handle this automatically, so no additional configuration is needed.

iOS Podfile Configuration

The plugin automatically configures your Podfile with the following settings:

# Source configuration for Cloudsmith
source 'https://github.com/CocoaPods/Specs.git'
source 'https://dl.cloudsmith.io/public/lazarilloapp/ios/cocoapods/LZSDKMaps/index.m3u8'
 
# Minimum iOS version
platform :ios, '14.0'
 
# Post install hook for proper configuration
post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES'] = 'YES'
      config.build_settings['DEFINES_MODULE'] = 'YES'
      config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
    end
  end
end

Troubleshooting

If you have compilation issues:

1. Clean project:

flutter clean
cd ios
rm -rf Pods Podfile.lock
pod install

2. Reopen project:

open ios/Runner.xcworkspace  # iOS

📋 Requirements

iOS:

• iOS 14.0+
• Xcode 12.0+
• CocoaPods 1.10.0+

Android:

• Android API 24+ (Android 7.0)
• Gradle 7.0+

🎯 Easy Integration Features

• 🔧 Automatic configuration: No manual modifications required
• 📱 Plug-and-play: Simple and direct installation
• 🛡️ Automatic dependency handling: Resolves conflicts automatically
• 📦 Transparent integration: Works with any Flutter project
• 🚫 No client modifications: Doesn’t touch client project files

📖 Quick Usage

import 'package:lazarillo_maps/lazarillo_maps.dart';
 
// Initialize
final lazarilloMaps = LazarilloMaps('your-api-key');
await lazarilloMaps.initialize();
 
// Create map widget
final mapWidget = lazarilloMaps.getLazarilloMapWidget(
  MapConfiguration(
    parentPlaceId: 'your-place-id',
    latitude: 40.7128,
    longitude: -74.0060,
    zoom: 15,
  ),
  (mapId) => print('Map ready: $mapId'),
);

🆘 Support

If you have issues:

1. Verify you meet minimum requirements
2. Run flutter clean and reinstall
3. Check compilation logs
4. Contact support at lazarillo.app