phonegap-app-developer - GitLite

KO | EN

gitlite — search

#javascript #python #react #ai #llm #rust #macos #java #awesome-list #vue #pytorch #security #mcp #openai

phonegap-app-developer

(★ 1,971)

PhoneGap Developer App

파일 탐색기

최종 버전 다운로드 (.zip)

- config.yml
- - build-android.sh
  - build-ios.sh
  - setup.sh
  - test.sh
- - icon-512.png
  - icon.psd
  - icon.svg
- - app.less
  - bot.less
  - form.less
  - mixins.less
- - add-hockeyapp.js
  - add-version.js
  - after-test-runner.js
  - before-test-runner.js
  - clean.js
  - compile-less.js
  - copy-android-push-icon.js
  - hockey-app.js
  - remove-hockeyapp.js
  - remove-version.js
  - restore-config.js
  - setup-ad-hoc.js
  - setup-directories.js
- - .gitkeep
- - .gitignore
- - index.spec.js
- - AndroidBridgePerformance_300.pdf
  - beep.wav
  - config.xml
  - CONTRIBUTING.md
  - cordova-incl.js
  - index.html
  - LICENSE
  - main.js
  - master.css
  - NOTICE
  - README.md
  - VERSION
- - app.css
  - NOEDIT.md
- - frame.png
  - monitor-alert-wp8.png
  - monitor-wp8.png
  - scanline.png
  - sprite.png
- - analytic.js
  - app.js
  - deploy.js
  - ms-viewport.js
  - nacl-fast.min.js
  - nacl-util.min.js
  - zepto.min.js
- index.html
.eslintignore
.eslintrc.yml
.gitignore
.travis.yml
CHANGELOG.md
config.xml
CONTRIBUTING.md
COPYRIGHT
google-services.json
LICENSE
NOTICE
package-lock.json
package.json
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/phonegap/phonegap-app-developer

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd phonegap-app-developer

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

$ npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

$ npm run phonegap -- <command> [args]

이 명령어를 터미널에 그대로 입력해 실행하세요.

$ npm run phonegap -- --version

이 명령어를 터미널에 그대로 입력해 실행하세요.

$ npm run phonegap -- run ios

이 명령어를 터미널에 그대로 입력해 실행하세요.

$ npm run phonegap -- run android

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# PhoneGap Developer App [![Build Status][travis-ci-img]][travis-ci-url]

> Available in an app store near you!

## Overview

The PhoneGap Developer app is a testing utility for web developers and designers
using the PhoneGap framework. After installing the PhoneGap Developer app you
can connect to your PhoneGap desktop app to instantly view and test your project
on the device.

For more information, see [Developer App Reference Guide][3] on the PhoneGap Docs.

## Download

- [Android Google Play][1]
- [Windows Phone store][7]

## Documentation

- [Developer App Reference Guide](http://docs.phonegap.com/references/developer-app/)
- [FAQ/Troubleshooting](http://docs.phonegap.com/references/developer-app/troubleshoot-faq/)
- [Unable to Connect or Download from Server](http://docs.phonegap.com/references/developer-app/troubleshoot-faq/#phonegap-developer-app-is-unable-to-download-from-the-server)

## Development

### Setup

The repository includes everything required to compile the app. You can get
setup by:

```shellsession
$ git clone https://github.com/phonegap/phonegap-app-developer.git
$ cd phonegap-app-developer/
$ npm install
```

### Compile and Run

The app bundles the `phonegap` npm module as a dependency. This means that
there is no need for a global installation of `phonegap` or `cordova`.
By editing the `package.json`, you can specify the exact version of `phonegap`
to compile the project.

Since a global install of the `phonegap` module is not required, we use
`npm run` scripts to compile and run the application. This allows the app's
`platforms/` and `plugins/` directories to be removed and rebuilt each time,
ensuring a consistent build using the correct PhoneGap, Cordova, platform,
and plugin versions.

The command structure is:
```shellsession
$ npm run phonegap -- <command> [args]
```

For example, you can check the version of `phonegap`:
```shellsession
$ npm run phonegap -- --version
```

You can compile and run iOS or Android:
```shellsession
$ npm run phonegap -- run ios
$ npm run phonegap -- run android
```

For developers wishing to use the platform SDKs (Xcode, Eclipse, Visual Studio),
please build once with the CLI to correctly populate the platform assets:
```shellsession
$ npm run phonegap -- build <platform>
```

Due to a Windows npm bug, the `--` does not work. Therefore we have created
run script that will build Windows Phone 8, so it can run in Visual Studio.
```shellsession
$ npm run phonegap-wp8
```

### Running the Tests

There are two types of test targets: the local app and served app.

#### Test the Local Application

The local application is the PhoneGap Developer App. To test the local
functionality, we build the application with mobile-spec. This allows us to
ensure that each plugin was correctly installed. Eventually, we would like
to add functional tests for the app logic.

You can run the local tests with:
```shellsession
$ npm run phonegap -- run android --test
$ npm run phonegap -- run ios --test
```

Again for Windows Phone, we have a run script that will build the app so it can run in
Visual Studio.
```shellsession
$ npm run phonegap-wp8-test
```

#### Test the Served Application

The served application is the app served by the CLI. To test the server
functionality, we serve an instance of mobile-spec. We can then use the manual
and automatic tests to ensure that the server provided the correct version of
Cordova, the plugins, and the navigation logic.

You can run the served tests with:
```shellsession
$ cd tests/
$ phonegap serve
# now connect with the latest build of the PG App
```

### Updating the Tests

It's as easy as a copy and paste.

1. Copy all content of `cordova-mobile-spec`
2. Paste the content into `tests/www`

On your first run of the tests, you may see some modified files. This is expected
because the test runner invoked by `--test` modifies certain files to support
our app's configuration.

### Adding Custom Plugins

If you're a developer interested in creating your own custom build of the
PhoneGap Developer App, then this section is for you!

Since the PhoneGap Developer app bundles `phonegap` as a npm dependency and
treats the `platforms/` and `plugins/` as artifacts, you'll find that it is very
easy to add your own plugins and alter other aspects of the app.

You may visit the [PhoneGap docs](http://docs.phonegap.com/references/developer-app/custom-build/ios/) for a more in-depth guide or follow the steps below.

First, [Setup](#user-content-setup) the project on your local system.

Second, edit the `config.xml` to add a custom plugin, change a preference, or
configure the app's name. You should also change the app's id to your own
unique app bundle id:

```xml
<?xml version='1.0' encoding='utf-8'?>
<widget id="org.mycompany.phonegap.app" version="1.6.2" xmlns="http://www.w3.org/ns/widgets" xmlns:gap="http://phonegap.com/ns/1.0">
```

Third, follow the [Compile and Run](#user-content-compile-and-run) section to
get the app onto your device.

If you run into any problems, feel free to [submit an issue](https://github.com/phonegap/phonegap-app-developer/issues).

### Releases

Releases are also generated using the npm scripts:
```shellsession
$ npm run release-android
$ npm run release-ios
$ npm run release-wp
```

In order to properly code-sign Android and iOS, you must setup the signing key.
This is accomplished by cloning the signing key repository and sym-linking each
platform directory with the PhoneGap Developer App repository:
```shellsession
# in your development directory
$ git clone https://github.com/phonegap/phonegap-app-developer-keys.git

$ cd path/to/phonegap-app-developer/
$ ln -s /path/to/phonegap-app-developer-keys/keys/ios resources/signing/ios
$ ln -s /path/to/phonegap-app-developer-keys/keys/android resources/signing/android
```

### Contributing, Commits, and Tags

See the [CONTRIBUTING.md][6] file for details.

[1]: https://play.google.com/store/apps/details?id=com.adobe.phonegap.app
[3]: http://docs.phonegap.com/references/developer-app/
[4]: http://github.com/phonegap/connect-phonegap
[5]: http://github.com/phonegap/phonegap-cli
[6]: https://github.com/phonegap/phonegap-app-developer/blob/master/CONTRIBUTING.md
[7]: http://www.windowsphone.com/en-us/store/app/phonegap-developer/5c6a2d1e-4fad-4bf8-aaf7-71380cc84fe3
[travis-ci-img]: https://travis-ci.org/phonegap/phonegap-app-developer.svg?branch=master
[travis-ci-url]: http://travis-ci.org/phonegap/phonegap-app-developer
[bithound-img]: https://www.bithound.io/github/phonegap/phonegap-app-developer/badges/score.svg
[bithound-url]: https://www.bithound.io/github/phonegap/phonegap-app-developer