kpostal 0.2.0

Kpostal package can search for Korean postal addresses using Kakao postcode service. This package is inspired by Kopo package that is discontinued.

About kpostal

Kpostal package can search for Korean postal addresses using Kakao postcode service.
This package is inspired by Kopo package that is discontinued.

By default, it uses the Address Search page hosted on Github.
It's the easiest way to use it.

To respond to errors that arise from hosting problems, we also support hosting local server.

Support Null-Safety!

Getting Started

Add kpostal to your pubspec.yaml file:

dependencies:
  kpostal:

Setup

🧑🏻‍💻 Neither iOS nor Android requires any action when using default hosting.

❗ Use local server

If you use the [useLocalServer] option to host a local server, you should make the platform specific settings required for http communication.

Android

Add android:usesClearextTraffic="true" to

<application
        android:label="[your_app]"
        android:icon="@mipmap/ic_launcher"
        ...
        android:usesCleartextTraffic="true"
        ...
        >  
    ...
</application>

iOS

Add NSAppTransportSecurity to info.plist file.

<plist version="1.0">
<dict>
    ...
    <key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>
    ...
</dict>
</plist>

Example

import 'package:kpostal/kpostal.dart';

// Use callback.
TextButton(
    onPressed: () async {
        await Navigator.push(context, MaterialPageRoute(
            builder: (_) => KpostalView(
                callback: (Kpostal result) {
                    print(result.address);
                }, 
            ),
        ));
    },
    child: Text('Search!'),
),

// Not use callback.
TextButton(
    onPressed: () async {
        Kpostal result = await Navigator.push(context, MaterialPageRoute(builder: (_) => KpostalView()));
        print(result.address);
    },
    child: Text('Search!'),
),

// Use local server.
KpostalView(
    useLocalServer: true, // default is false
    localPort: 8080, // default is 8080
    callback: ...
)