帮酷LOGO
0 0 评论
  • 显示原文与译文双语对照的内容
文章标签:EDX  
Appsembler branded iOS app for edX

  • 源代码名称:edx-app-ios
  • 源代码网址:http://www.github.com/edx/edx-app-ios
  • edx-app-ios源代码文档
  • edx-app-ios源代码下载
  • Git URL:
    git://www.github.com/edx/edx-app-ios.git
  • Git Clone代码到本地:
    git clone http://www.github.com/edx/edx-app-ios
  • Subversion代码到本地:
    $ svn co --depth empty http://www.github.com/edx/edx-app-ios
    Checked out revision 1.
    $ cd repo
    $ svn up trunk
    
  • 这是edX移动iOS应用的源代码。 它正迅速变化,它的结构不应依赖于。 有关edX代码库的其他部分,请参见 http://code.edx.org

    它需要"dogwood"版本的开放edX或者更新版本。 有关更多信息,请参见 https://openedx.atlassian.net/wiki/display/COMM/Open+edX+Releases

    许可证

    这里软件在Apache许可版本 2下许可,除非另行说明。 有关详细信息,请参见 LICENSE.txt

    建筑

    查看源代码:

    git clone https://github.com/edx/edx-app-ios

    打开 edX.xcworkspace

    确保选择了 edX 方案。

    单击运行按钮。

    注意:我们的构建系统需要java5或者更高版本。 如果你看到了提到"不支持的major.minor 版本 51.0"的错误,那么应该安装更新的Java SDK。

    配置

    edX移动iOS应用被设计用来连接一个开放的edX实例。 你必须使用正确的服务器地址配置应用程序并提供适当的OAuth凭据。 我们使用与开放edX平台类似的配置文件机制。 这里机制还用于在运行时使它的他值可以用于应用程序并存储第三方服务的秘密密钥。

    有一个默认配置指向运行在本地主机上的edX devstack实例。 请参阅 default_config 目录要运行缺省配置,必须添加特定于你的安装的OAuth凭据。

    设置

    要使用自定义配置代替默认配置,你需要完成以下任务:

    1.在文件系统的其他位置创建你自己的配置目录。 例如创建 my_config 作为 edx-app-ios 存储库的兄弟节点。

    2.在 edx-app-ios 存储库的顶层创建一个 edx.properties 文件。 在这里 edx.properties 文件中,将 edx.dir 属性设置为配置目录的路径。 例如如果我在 ../my_config 存储配置,那么我将拥有以下 edx.properties:

    edx.dir = '../my_config'

    3。在步骤 1中添加的配置目录中,创建另一个 edx.properties 文件。 这里属性文件包含一个文件名列表。 这些文件应该采用YAML格式,用于存储特定的密钥。 这些文件是相对于配置目录指定的。 列表前面的文件中的键将由列表后面的文件中的键覆盖。 例如如果我有两个文件,一个在iOS和Android之间共享,一个名为 shared.yaml的iOS,一个名为 ios.yaml的,我将拥有以下 edx.properties:

    edx.ios {
     configFiles = ['shared.yaml', 'ios.yaml']
    }

    可以在 OEXConfig.m 中找到完整的密钥集,或者参阅附加文档

    附加自定义

    现在这段代码是专门构建的,用于构建的edx.org 应用程序。 我们正在努力使开放edX安装更容易应用定制并选择第三方服务而不必修改存储库本身。 在完成该工作之前,你需要修改或者替换 repo的fork 中的文件。

    要替换edX品牌,你需要替换 appicon 文件。 这些都有许多解决方法。 有关不同应用程序 icon 大小的详细信息,请参阅苹果文档。 此外,你还需要替换登录屏幕中使用的splash 图像。

    如果需要更多地进行深度界面更改,那么在 Main.storyboard 文件中指定大多数用户界面。

    如上所述,应用程序依赖于第三方服务的存在: Facebook,NewRelic,Google+,SegmentIO和 Crashlytics。 你必须删除对每个你选择不使用的服务的引用。 你可以注释出那些提到这些服务的行。 我们正在使这些依赖项成为可选的。

    Whitelabel脚本

    为你的应用程序签出一个新分支,e.g.

    git checkout -b my-new-app

    重置到所需的上游引用,e.g.

    git reset --hard master

    创建用于 whitelabel 脚本的virtualenv,并安装依赖项。 Python2.7 或者 Python3.x 将工作。

    virtualenv edx-app-ios
    source edx-app-ios/bin/activate
    pip install pyyaml

    在单独的目录中,创建whitelabel配置文件,比如 ../my-app-config/whitelabel.yaml 运行 whitelabel 脚本以查看选项:

    python script/whitelabel.py --help
    python script/whitelabel.py --help-config-file

    在单独的目录中,可以选择创建资源目录和文件。 比如,更新 colors.json file:

    mkdir -p.. /my-app-config/Resources/Colors
    cp Sources/Resources/Colors/colors.json.. /my-app-config/Resources/Colors/
    # edit.. /my-app-config/Resources/Colors/colors.json as required

    运行 whitelabel.py 脚本将whitelabel更改应用到当前分支。

    python script/whitelabel.py --config-file=../my-app-config/whitelabel.yaml -v


    文章标签:EDX  

    Copyright © 2011 HelpLib All rights reserved.    知识分享协议 京ICP备05059198号-3  |  如果智培  |  酷兔英语